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ABSTRACT 



The microprocessor revolution has oroduced a capable 
computer on a single printed circuit board. 

The design and development of a real-time operating 
system for a distributed system of Single Board Computers is 
oresented in this paper. 

There are user manuals and program descriptions for the 
operating system* a debug module* a CRT module and a line 
printer module. 

The operating system has been developed for a Multibus 
system with three INTEL Single Board Computers SBC80/20-4 
and 64K bytes of common memory. 

The system has been designed specifically for Naval 
Tactical Data Systems applications and the feasibility of 
such applications are evaluated with respect to currently 
available Single Board Computers and with respect to Single 
Board Computers that should be available in the near future. 
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INTRODUCTION 



An examination of currently installed Naval Tactical 
Data Systems reveals that the heart of the system, the 
computer, does not represent today's advanced technology. 
Even in recently implemented systems large 'space, weight, 
power and maintenance cost consuming' second generation 
computers are found. The use of second generation technology 
is caused by lengthy lead times in systems acquisition, 
system conversion and especially software conversion cost, 
educational cost etc. However, in the age of 
m i c rocomput er s t which provides features like low hardware 
cost , high degree of versatility and therefore a potential 
for standardization, high reliability, low maintenance cost 
and low power, space and weight consumption, it should be 
the time to develop new systems in order to make use of 
these features which seem to be tailored specifically for 
military applications. 

The real-time operating system developed in this thesis 
should be understood as a step in the direction of making 
use of the new technology. The operating system is designed 
for a distributed system of concurrently operating Single 
Board Computers. 
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After identifying typical computing requirements for 
Naval Tactical Data Systems* a distributed computer system 
using Single Board Computers and a real-time operating 
system are developed. Three user modules* a debug* CRT* and 
a line printer module* are introduced. In the conclusion of 
this paper a comparison between the identified requirements 
and the developed system is made and possible extensions are 
indicated. 
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II. COMPUTING .REQUIREMENTS FOR NAVAL TACTICAL DATA SYSTEMS 



In this section the basic requirements for a computer 
system which is to drive a Naval Tactical Data System are 
cons i de red . 

In general it can be said that the computer system has 
to be able to handle the workload dictated by the 
operational specifications and to cooe with peak situations 
without a system failure. 

Typically* Naval Tactical Data Systems are dedicated 
systems. Because of this fact* system requirements for the 
CPU* memory and input/outout are known. It is therefore not 
necessary to carry a vast amount of overhead in order to be 
prepared for unknown worst cases. However* when deciding on 
a computer system* future extensions of the system with 
hardware consequences should be taken into account. 
Un f o r t un a t e 1 y it is very difficult to predict the possible 
enhancements during the life time of a Naval Tactical Data 
System. Therefore* the chosen computer system should be 
expandab 1 e . 

Since Naval Tactical Data Systems are rather complex 
systems with many different system functions* the equipment 
used in an implementation is produced by many different 
manu f ac t urers . Although there are some standard interfaces 
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for Naval Tactical Data System, the computer, which is to 
drive the peripheral hardware has to be versatile in order 
to be connected to different devices with different 
interfaces. 

In order to reduce cost by large series and simplified 
maintenance a standardization between different systems is 
highly desirable. 

The instruction repertoire of the computer system has 
to provide instructions which allow the efficient 
proqramminq of typical operations in Naval Tactical Data 
Systems. Typical operations are 

- the solution of complex mathematical problems 
in a reasonable time (quasi real-time) 

- bit manipulations 

- fast data base access 

- complex and fast inout/output operations 

- extensive interrupt handling. 

Many command and control operations and decisions 
depend on the proper function inq of the Naval Tactical Data 
System. Hiqh reliability, even under extreme physical 
conditions, are therefore a too requirement for this kind of 
system. In case of a breakdown, the tactical information 
often is lost or it takes some time to recreate a valid 
tactical situation. Because of the importance of the Naval 



Tactical Data System within 



a larger system (ship or 



aircraft)# a complete back-up for the computer system is 
des i rab 1 e . 

The major requirement to be met by the operat inq system 
is to run the system under real-time conditions. Dependant 
on the computer system# this leads to operating systems of 
differing sizes where the ratio of time used by the 
operating system to total time should be optimized. 

Basically# the operating system has to support an 
overall Droqram structure which simplifies 

- software development 

- software maintenance 

- software extensions 

- use of components from other systems 
(standard i zat ion) . 
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A COMPUTER SYSTEM USING SINGLE BOARD COMPUTERS 



In this section the hardware concept of a computer 
system consisting of Single Board Computers is developed* 
Basic building block of this computer system is a INTEL 
Single Board Computer, SBC80/20-4. 

A. INTEL’S SINGLE BOARD COMPUTER SBC80/20-4 

INTEL'S Single board Computer, S8C80/20-4, represents a 
comolete' microcomputer on a single or i nted circuit board. 

The SBC80/20-4 includes: 

- 8 0 8 0 A CPU 

• 4 K static Random Access Memory (RAM) 

- up to 8K Read Only Memory (ROM) 

- 48 programmable parallel input /output lines 

• a programmable serial input/output interface 

- programmable interval timers 

- programmable, eight priority level, vectored 
interrupt structure 

• bus interface for external system bus. 

An in-depth description of hardware, function and 
programming of the SBC80/20-4 is given in the SBC80 manual 
[INTEL SBC80/20 HARDWARE REFERENCE MANUAL 98-317c). 
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8 0 8 0 A CPU 



The 8080A is a sinqle LSI chip CPU. It has six 
8-bit general purpose reaisters and an accumulator. The six 

qeneral purpose registers may be addressed individually or 

\ 

as register pairs, providing 16-bit operations. 

A 16-bit stack pointer controls the addressing of an 
external stack which can be located in general memory. 

The 8080A has an address range of 64K bytes. 

The CPU Set consists of the 8080A CPU,clock 
.generator and a system controller. It performs all system 
processing functions and provides a stable timing reference 
for all other circuitry on the board. 

2. Random Access Memory/Read Only Memory 

The 4 K Random Access Memory on the Sinqle Board 
Computer can be jumper assigned to the top address space in 
any one of the four 16K address blocks. 

The Read Only Memory is located starting at address 
0000 and has a size of 4 K or 8K depending on the type of me- 
mory devices used. 

The full CPU capability of addressing 64K bytes can 
be utilized by adding external memory boards which are 
accessible via the system bus. The respective parts in this 
memory are 'shadowed' by the on-board memory. The CPU set 
is capable of determining whether an addressed 



memory location is on-board or not. 

3 . Parallel Inout/Outout 



The SBC provices 48 input/output lines which can be 
configured by software in combinations of un i -d i r ec t i ona 1 or 
bi-directional input/outout ports. 

4. Serial Input/Outout 

The SBC includes a programmable 
synchronous/asynchronous RSP3PC communication interface 
which is capable of operatinq with all common communication 
frequencies. 

5. Interval Timers 



The SBC 
i ndeoenden t BCD 
counters. 



contains two fully programmable and 
or 16-bit binary interval timers/event 



6. Interrupt Structure 

The on-board interrupt controller provides vectoring 
for up to eight interrupt leves in four different priority 
processing modes. Operating mode and priority assignment 
are under software control. 

7. System Bus Interface 



This interface is compatible with INTEL'S Multibus 
system and allows the combination of several Single Board 
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Compu t e r s / memo ry and other utility boards on one system bus 



Two bus priority systems are available: serial (up 
to three master controller) and parallel (ud to sixteen 
master controller). 

B. SYSTEM CONCEPT 

The development of a comouter system consisting itself 
of rather independent Single Board Computers automatically 
leads to the concept of a distributed system. A distributed 
system in this context is a computer system in which seve- 
ral processors are working on more or less independent tasks 
connected by a common system bus. The computer system to be 
developed is a direct realization of this concept. 

Basically the system consists of Sinqle Board Computers 
and 6 4 K bytes of Random Access Memory external to the Sinqle 
Board Computers. The external memory resides on four printed 
circuit boards which are bus compatible with the Single 
Board Computers. This memory represents a common memory to 
all Single Board Computers attached to the same bus. This 
concept in connection with the on-board memory of the Sinqle 
Board Computers ooens up software possibilities which are 
explored in Chapter I V . 

Information interchange between Sinqle Board Computers 
can be realized using three different concepts. 
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Concept ( t ) 



Storage of information in common memory and periodic 
checks of the agreed uoon 'mail boxes'. This 
concept can be used in systems where all processing 
is organized in a hierarchical 'producer - consumer' 
structure. In this structure basic processing is 
local to a Single Board Computer. Data is gathered 
and processed at a high rate. The output* reduced 
data and updates of common data bases* is required 
by others processors at a lower frequency. Since 
external events can occur asy nc ronous 1 y * an extra 
data oath through common memory for such messages 
has to be provided. 



Concept ( 2 ) : 

Storage of information in common memory and 
interruption of the information receiving Single 
Board Computer. The addition of interrupts to 
concept (1) allows both synchronous and asynchronous 
transfers of data sets between Single Board 
Computers. The disadvantage of this concept is the 
number of interrupt lines reauired with an 
increasing number of Participating Single Board 
Computers in order to address each other. The 
alternative of having only one interrupt common to 
all Single Board Computers would cause an 
interruption of all processors and requires a 
polling scheme to determine the receiving Single 



Board Compu ter. 



Concept ( 3 ) : 

Direct transfer of information between Sinale Board 
Computers using input /output ports ana interrupts. 
This concept can be used to exchange time critical 
information between Processors. Since it directly 
involves the CPU of both the sender and receiver the 
amount of aata passed has to be keot small. 
However* larae data sets can be transferred with the 
use of pointers to common memory. The limitations 
of conceot (2)* extended for data lines between 
input/output ports* also apply for concept (3). 

The input/output structure of the Single Board Computers 
allow the connection of a variety of peripheral devices to 
the computer system. Each connection represents a hardware 
modification or specialization of a Single Board Computer* 
i.e. the dedication of a part of the computer system to a 
spec i a 1 task. 

C. SYSTEM BUS ORGANIZATION 

The system bus* which is the main communication line 
between several Single Board Computers* common memory and 
other utility printed circuit boards* is implemented using 
INTEL* s Multibus. This bus system allows master-master and 
master-slave relationships between various system hardware 
modu 1 e s . 
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Transfers via this bus oroceed asynchronously# i . e . the 
transfer speed is dependent on the speed of the transmitting 
and rece ivinq devices. (3 nee a module has gained control of 
the bus# transfers can proceed with a maximum rate of 5 
million bytes/second. 

Master modules can qain access to the bus using a serial 
or parallel priority resolving scheme. The serial scheme is 
limited to three masters because of the signal propagation 
delay# but up to sixteen masters may be connected to the bus 
using the parallel priority scheme. 

The bus system provides an override facility which 
allows a hardware module to keep control of the bus until 
the operation is completed. This feature can be used under 
software control. 

D. MEMORY organization 

The total memory of the computer system consists of 

- common Random Access Memory 

- on-board Random Access Memory 

- on-board Read Only Memory. 

The on-board Random Access Memory portions are located 
in the same region on all Single Board Computers. This 
leaves the respective Portion in common memory unused# 
however# it is now possible to run identical programs on the 
Single Board Computers. Identical proarams allow the access 
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of common data and execution of shared code. The location 
of on-board Random Access Memory can be changed because all 
programs are relocatable. 

All variable data has to be kept in on-board memory for 
two reasons : 

1) Faster access by CPU and increased overall 
performance because use of the system bus is 
avoided. 

On-board memory access does not require WAIT states 
of the CPU. 

2 ) No data conflicts in the execution of shared code. 
Although the variable data has the same logical 
address so ace/ its physical representation is local 
to the Single Board Computers and therefore 

9 invisible 1 to other CPUs. 

On-board Read Only Memory contains the executive and 



frequent 1 y 


execut ed 


program parts. Other 


p r og r am 


parts; 


especial 1 y 


when 


they 


are identical in all 


Single 


Boa rd 


Computers 


are 


located in common memory in 


o rde r to 


allow 



shared execution. 
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E 



iNPuT/ourpur facilities 



Each Single Hoard Computer provides serial and parallel 
input/output facilities which can be completely driven by 
i nterrupts. 

The serial interface is ready to be used with a CKT. 
With the addition of an adapter a TTY can also be connected 
to a Single Board Computer. 

Each Single Board Computer provides six bi -Directional 
8-bit ports. These ports can be configured by software to be 
8-bit data input/output ports or 4-bit bit addressable 
input /output ports. The latter can be us e a to receive and 
send status bit information in conjunction with the 8-bit 
input/output ports. 

The hardware provides three basic modes of operation 
that can be selected by software: 

- Mode 0 : Basic Input/Output 

- Mode 1 : Strobed Input/Output 

- Mode 2 : Bi-directional Bus 

Mode 0 can oe usea for simple/ status driven device 
interfaces. Since this kind of interface is not compatible 
with the real-time recuirements it is not considered here. 

Mode 1 and Mode 2 generally require the support of 
interrupts. Mode 1 provides a means for transferring data 
to or from a specific port in conjunction with strobe or 
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'hand-shake* signals. This mode can be used for a variety of 
different peripheral devices. 

Mode 2 provides communication with a peripheral device 
on a 8-bit bus for both receiving and transmitting data. 
'Hand-shake* are provided to maintain proper bus flow in a 
similar manner to Mode 1. 

The driver/termination connections of the parallel 
input/output section are left open and have to be inserted 
depending on the actual implementation. 

The primary user considerations in determining how to 
use each of the six input/output ports areZ 

- choice of operating mode 

- direction of data flow 

- choice of driver/terminator networks 

- jumper configurations 

- mutual port restrictions. 

F. INTERRUPT STRUCTURE 

The interrupt controller accepts jumper selectable 
interrupt requests from 

- parallel input/output 

- serial input/output 

- interval timers 

- system bus 
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- directly from external aevices* 

The controller resolves priority among the eight 
possible interrupt levels according to an algorithm which is 
selectable by software. The priority assignments and 
algorithms can be changed dynamically at any time during 
system ope ration. 



Of 


the 


four 


PO s s 


i b 1 e interrupt 


modes only 


the ’fully 


nested 


1 mode is 


cons 


ioered here. 


I n 


this mode pri 


orities are 


fixed 


such 


that 


1 eve 


1 0 has the 


highest priority 


and level 7 



the lowest. 

The interrupt hardware provides vectored interrupts 
where the interrupt vector is not fixed in its location and 
size (4 or 8 by t es / i n t e r r up t ) . The interrupt controller has 
to be programmed with location and step width of the 
interrupt vector. 

The interrupt controller allows the setting of a one 
byte interrupt mask by software. This feature allows the 
inhibition of not wanted interruots in any combination of 
the eight interrupt levels. 
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TV. A R E A L - T I ME OPERATING SYSTE M FOR SINGLE BOARO COMPUTERS 



The objectives for the operating system to be developed 
in this section are: 

1) The operating system has to be able to control NTDS 
applications under real-time conditions. 

2 ) The host computer system is the multi processor 
microcomputer system cescribed in the previous section. 

3) The existing Microcomputer Development System and 
the associated support software ( I S I S- 1 I , PL/M-80 ) has to be 
used for program development. 

4 ) The operating system must provide debugging tools 
that allow system debuggina and system testing under real- 
time conditions. 

This chapter describes the operating system in more 
general terms. An in-deoth description is qiven in the 
user's manual (Appendix A) and in the program description of 
the operating system (Appendix B). 

A TASK is a part of the program which handles a 
specific function of the system and consists of one or more 



procedures 



A MODULE is a seoarate task or separate group of 
related tasks which are considered to be independent in 
terms of software development and system integration. 

The EXECUTIVE is the kernel of the operating system and 
controls the scheduling and execution of tasks* 

The OPERATING SYSTEM consists of executive/ system 
calls and system data. 

A, SYSTEM CONCEPT 

In contrast to an operating system for general usage in 
which the nature of the running tasks is not predictable 
this real-time operating system drives a dedicated system. 
Dedicated/ in this context/ means that the implemented tasks 
do not change at run time of the system. This concept allows 
dropping much of the book-keeping overhead which is typical 
for ooeratinq systems for general usage. Tasks in this 
system are not physically moved in memory/ they are only 
activated and suspended. 

Execution of tasks is under control of the kernel of the 
operating system/ the executive. The executive controls the 
CPU assignment to the various tasks activated by interrupts/ 
to process a message from another task or at a preset point 
in time. 
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B. MODULAR STRUCTURE 



The operating system supports a strictly mociular program 
structure* Modules are integral parts of the overall proqram 
which usually handle a specific function or a group of 
related functions. This organization not only eases program 
development and mai ntenace^ it also allows easy-to-implement 
changes of the system. Typically/ a module is compiled 
separately and then intearated into the rest of the system. 
Because of the independent nature of modules they can be 
removed or replaced without influencing the remaining 
system. Not only user programs represent modules/ the 
operating system itself consists of independent modules. 

Modules are identified by a number. The number depends 
on the number of the S inale Board Computer which hosts the 
module. Maximum number of modules oer Single Board Computer 
is S. Modules in Single Board Computer 1 have numbers 0 to 
7/ in Single Board Computer 2 numbers 8 to 15 etc. The 
lowest module number in a Single Board Computer is reserved 
for the executive of the operating system while the hiqhest 
number represents the debug moaule. 

C. FACILITIES OF THE OPERATING SYSTEM 
1. Priority Tasks 

Priority tasks represent the highest priority level 
a task can have in the system. Priority tasks are executed 
as soon as processor control is returned from the current 
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active task. 



A priority task has to be entered into the list of 
priority tasks with a system call. A single execution of 
that priority task can then be scheduled with another system 
call. 



The primary purpose of priority calls is the process 
of interrupts. The call of the priority task has to be 
scheduled in the interrupt service routine. The high 
priority of that task ensures that it is executed as soon as 
the processor becomes available. 

2 . Communication between Modules 

Since modules are separate and independent parts of 
the system the operating system has to provide a function 
which allows the tasks or modules to communicate with each 
other. This communication uses the form of messages which 
are sent from one module to another. A message is sent with 
a system call and entered into a FIFO list. The receiving 
module's messaae entry is called if no priority task is 
pendinq and the message is to be processed next in the FIFO 
list. 



A message consists of message control block and 
possibly data bytes. The message control block identifies 
receiving module/ sencing module/ message number and length 
of the message. The message number depends entirely on an 
agreement between sending ana receiving module and serves 
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the ouroose of identifying the message. If the message 
control block itself is not sufficient for the transmission 
of information, data bytes can be added to the messaqe. 

A message is always sent from one module to another 
module regardless in which Single Board Computer they 
reside. The operating system decodes the number of the 
receiving module and routes the message to another Single 
Board Computer if necessary. 

i . Time Dependent and Periodic Tasks 

Real-time environments and especially Naval Tactical 
Data Systems require the execution of certain tasks at a 
predefined point in time or periodically with a specified 
time interval. In this operating system these tasks range 
in the priority hierarchy below the priority tasks and the 
process of messages. 

Periodic tasks have to be identified to the 
operating system with a system call, with this system call 
the task and the specified time interval is entered into the 
list of periodic tasks. The executive uses the system 1 s 
real-time clock to determine the exact time of the call. A 
periodic task can be suspended or the specified time 



interval can be changed with system calls 



'4 , Background Tasks 



Background tasks represent the lowest priority level 
in the system. They are executed only if no priority task 
is pending^ no messaae is to be processed and no periodic 
call is necessary/ i.e. the processor is idling. This idle 
time can be used to perform hardware checks on a time slice 
basis or to perform data reductions for statistic and test 
purposes* 

If a Single Board Computer is completely interrupt 
driven/ (i.e* not periodically activated) the processor can 
enter the HALT state to free the system Dus. The next 
interrupt will ’awake’ the processor and the executive. 

5, System Calls 

The operating system provides system calls for task 
management/ communication between modules and functions 
which are commonly used by several modules. 

6. Real-time Clock and Count Down Clock 

The operating system provides two different clocks / 
a continuously running real-time clock and a count down 
clock which can be started with a specified run time. There 
is only one real-time clock in common memory which is used 
by all Single Board Computers in the system. The real-time 
clock is driven by the Single Board Computer with the number 
1. Both real-time clock and count down clock make use of 
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the interval timers on the Single Board Computers. 

A count down clock is implemented in each Single 
Board Comouter. The count down clock can be started at any 
time and generates an interrupt when the specified time is 
elapsed. The count down clock can be used to control time 
critical processes. It has a size of 16 bits where the least 
significant bit represents 1.86 micro seconds. 

The real-time clock has a size of 4 bytes / the least 
sionificant bit has the value of 1 milli second and the 
maximum run time is approximately 50 days. 

D. REAL-TIME EXECUTIVE 

The real-time executive represents the kernel of the 
operating system. The executive continuously checks for 
pending tasks on four priority levels: 

1. priority tasks 

2. messaqes to be processed 

3. periodic tasks 

4. background tasks. 

The processor is assigned to the next task with highest 
priority in this scheme. The executive only proceeds to the 
next lower level if no task is pending at the current or a 
higher level. 
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Each Sinqle doaro Computer runs its own/ identical 
executive* An executive is tailored to its environment with 
special comoile parameters. 

The executives in different Single Board Computers 
communicate with each other using normal messages via an 
exchanqe in an absolutely located buffer in common memory* 

Because the code of the executive is executed most often 
it is located in on-board memory. 

E. INTERRUPT HANDLING 

All interrupts are handled entirely by the operating 
system. The operating system initializes the interruot 
controller and sets up the interruot vector. 

There are four special interrupts which are handled by 
the operating system: real-time clock interruot/ count down 
clock interrupt/ system restart interrupt ana an interrupt 
which causes the system to enter the monitor/ if 
implemented. 

User modules can activate interrupts with a system call 
and passing the requested interrupt level and the index of a 
priority task to process the interrupt. In case of an 
interrupt/ a call of the priority task is scheduled by the 
ooerating system. The de-activation of an interruot is also 



performed with a system call 



F , SYSTEM MONITOR 

The system monitor is implemented as a system call. It 
is called when internal program limits are exceeded. An 
address value and two byte values are passed with the system 
call. The address can point to the location of the error 
and the two byte values can further specify the nature of 
the error. 

The system monitor generates the display of an 
appropriate message for the operator. 

This feature is primarily designed as an aide in the 
program development and test phase and to cover undefined 
program states. 

G. SYSTEM INTEGRATION 

User modules to run under the operating system are 
independent with respect to other user modules and the 
operatina system. In order to provide the necessary links 
to the operating system, a user module needs to be compiled 
together with some system data ana external declarations of 
the system calls. Furthermore the module’s entry for the 
process of messages has to be identified to the operating 
system. 

The linking of a module to the operating system is 
implemented using the public/external declaration feature of 
PL/M-80 and the LINK program in ISIS-II. Basically, a 
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system integration is the execution of this LINK program. 
Included in the linking process are the operating system 
itself and the user modules of the special configuration to 
be integrated. 

Depending on the application, the linked and located 
code can be kept externally and loaded into Random Access 
Memory or transferred into Erasable and Programmaol e Read 
Only Memory. 
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AVAILABLE USER MODULES 



V . 



Three user modules have been deve 1 ODed and are 
available to run in the presented system con f i gu r a t i on : a 
CRT module^ a line printer module and a debug module. The 
software documentation/ a Program description of each module 
and a user's manual for the debug functions* is part of the 
Append i x . 

A. CRT MODULE 

This module is a typical user module. It drives a CRT 
connected to a Single Board Computer, The CRT* via the CRT 
module* may be used by any other module in the system* 
regardless in which Single Board Computer it is located. 
Messages are used for the communication between the CRT 
module and a 'CRT user' module. 

The CRT module provides two different kinds of outputs 
to the CRT and the facility of obtaining inputs from the 
connected keyboard. 
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LIME PRINTER MODULE 



The line printer module is the driver for a line 
printer. Any module in the system can transfer text with a 
message to the line printer module in order to have it 
printed, 

C. DEBUG MODULE 

This module allows the debugging of the entire system 
under real-time condi t i o n s * i.e. without influencing system 
operation during the debugging process. The provided debug 
functions are designed to ease debugaing of malfunctions 
which are typically encountered in real-time systems and 
specifically in Naval Tactical Data Systems. 

The debugging concept allows several users to debug 
different program Darts at the same time. Any Single Board 
Computer can be debugged from any other Single Board 
Computer with the restriction that only one user is allowed 
to debug a Single Board Computer at a time. 

Inout/output media for the debug module are a CRT or 
equivalent device ana a high speed printer for output only. 
Both devices are driven by modules described in previous 
sections. 
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VI . CONCLUSIONS 



In this section a comparison is made between the 
oroDOsed computer system (hardware concept and operating 
system) and the requirements established in Chapter II, 

It is emphasized that no attempt is made to examine the 
capabilities of the previously described computer system to 
drive a typical Naval Tactical Data System. Obviously the 
CPU, INTEL’S 8 0 8 0 A , fails to qualify for this task because 
of its restricted instruction repertoire (especially the 
lack of arithmetic instructions)/ eight bit word size and 
6 4 K byte address space. 

With the recent introduction of a single chip 16-bit 
microprocessor with 

- instructions to operate on 8-/16- and 3 ? bit 
quant i t i es 

- signed and unsigned arithmetic operations 
includinq multiplications and divisions 

- address space of 1 meoabyte 

the proposed model with minor adaptive changes in the 
operating system becomes realistic/ provided that the 
concept of Single Board Computers will be keot. Considering 
the success of INTEL'S S8C80 series / ‘ thi s is very likely. 
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A. HARDWARE design 

1. Standardization and Cost 

The Proposed hardware design* distributed system 
with Single Board Computers on a common bus system* is very 
flexible. It can be used in Naval Tactical Data System 
applications which recuire extensive computing power as well 
as in very small ana simple systems. Because of this 
flexibility* the proposed concept would reduce the number of 
different computer architectures currently in use. This 
reduction is equivalent to an increase in standardization 
which besides lower hardware cost has a strong influence on 
cost in terms of software development* maintenance and 
training of Personnel. 

2 . Expandability 

The proposed concept has special advantages as far 
as future changes or extensions of the system are concerned. 
A hardware change is kept local to one or a few Single Board 
Computers. Extensions are accomplished easily by adding 
Single Board Comouters to the system. However* it should be 
noted that the utilization of the system bus may turn out to 
be the ’bottleneck* of such a system. The capacity of the 
system bus clearly dictates the limits for the proposed 
compu t e r aesiqn, 

A solution to this problem is thinkable in form of a 
1 super bus* structure cons i st i na of two or more of the 
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previously developed systems and a connecting ’super 1 bus 
system. This structure would lead to a strictly hierarchical 
system concept in which information is reduced before being 
transferred to the next higher bus level. 



3 . Interfaces with Peripheral Equipment 

The imolemented input/output interfaces in Single 
Board Computers are not fixed. The inout/outout and 
interrupt controller are software programmable and/ in 
connection with easy to implement jumper connections/ allow 
the tailoring of the input/output and interrupt facilities 
according to the application. 

4. Maintenance and Reliability 

The most astonishing effects of the new technology 
used in Single Board Computers can be found in the area of 
maintenance and reliability. A computer system consisting of 
Single Board Computers is practically inaintenance-f ree. 
Although reliability tests of the new technology are still 
in Progress/ it is already known that there is a great 
increase in reliability. In case of a failure parts of the 
computer would no longer be replaced: the computer would be 
replaced itself. 



5. Physical Requirements 



The proposed 
weight/ space and 



computer system drastically reduces 
environmental (power/ cooling etc.) 
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requirements of currently imolemented Naval Tactical Data 
Systems, This reduction is especially important for air- 
borne systems, 

6, System Redundancy 

Up to now a complete back-up computer system is not 
found in Naval Tactical Data System applications. Reasons 
for this are mainly costs and sometimes space and weight. 
With an implementation of the proposed system concept these 
constraints could be eliminated. Although reliability is 
already greatly increased a redundant system design can be 
considered. 

B. OPERATING SYSTEM 

1. Naval Tactical Data System Requirements 

The proposed operating system has been designed 
specifically for an application in Naval Tactical Data 
Systems. It provides facilities which ensure the real-time 
operation of the entire system. 'Real-time* is a relative 
expression with respect to Naval Tactical Data Systems. An 
operator expects a system reaction in real-time after 
completion of his inputs. In this case the system has to 
provide an ' instantenous' reaction in terms of human speed. 
However# in the case of a high frequency radar interface# 
‘instantenous* represents a considerably shorter time 
between input and reaction. The structure of the operating 
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system with different priority levels supports this 
interpretation of 'real-time' as well as other commonly 
found Naval Tactical Data System operations. 

2 . Software Development , Maintenance and Extensions 

Because of the modular structure supported by the 
operating system, it is possible to run test vehicles early 
in the program development phase. The modules in the test 
vehicle are replaced by the original modules as soon as they 
are completed or the simulated equipment is installed. This 
concept of a continuous test of the growing system involves 
some simulation overhead but it avoids 'biq bang' tests and 
leads to a better tested system. 

The modular structure also eases oroqram 
maintenance, because modules are easily changed and re- 
integrated into the system. 

Extensions to the system are implemented by adding 
modules. Hardware facilities of the computer system can be 
extended by increasing the number of Single Board Computers. 
In order to find an optimal distribution of the extended 
program it may be necessary to re-distribute the modules 
over the Single Board Computers. 

3. Standardization 

The structure of the operating system basically 



reflects a similar structure used in various real-time Naval 



Tactical Data Systems* This allows the use of already 
developed software ana knowledge* 

4 • Simulation 



Simulation in Nava) Tactical Data Systems is neeaed 
mainly for three reasons: software development/ software 
test and operator training. The modular software structure 
in connection with the distributed Single Board Computer 
concept allow simulation not only of missing modules or 
equipment/ it allows the simulation of the operation of 
entire Single Board Computers as well* No hardware changes 
are necessary since the simulation takes place entirely 
inside the computer system. 
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PROGRAM DESCRIPTION OF OPERATING SYSTEM 
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General 



Introduct ion 



This segment of text describes the function of the operating 
system. The use of the facilities is documented in the user’s 
manual for the operating system. 



In cases where system functions are well explained in the 
program listing itself no cescriotion is given here. 

The executive is considerea to be a module. It has the lowest 
possible module number in a SBC and the module identification 
EX, 



Abbreviations and Conventions 

All numbers in this segment of text are decimal except as 
otherwise indicated. 

Task - part of the program which handles a specific 

function of the system and consists of one or 
more procedures 



Module - part of the program which consists of one or more 
(related) tasks and can be compiled separately 

Executive * part of the operating system which controls the 
scheduling and execution of tasks 



Ope r a t i ng 

System - consists of executive, system calls and system data 



System 



consists of operating system and all integrated 
user modu 1 es 



SBC - Single Board Computer 

MDS - Microcomputer Development System (INTEL) 
MCB - Message Control Block 



RMN - Receiving Module Number 

SMN - Sending Module Number 

MN - Message Number 

ML - Messaqe Length 

EX - executive, module 

LP - line printer modu 1 e , modu 1 e 

CS - CRT module, module 

DB - debug module, module 

RTC - Real Time Clock 
CDC - Count Down Clock 



numbe r 


i n 


SBC 


1 /2/3 


00/08/lb 


number 


i n 


SBC 


1/2/3 


05/ 1 3/21 


number 


i n 


SBC 


1 /2/3 


0o/ lu/22 


numbe r 


i n 


SBC 


1/2/3 


07/15/23 



Executive 



The executive is the kernel of the operating system. 
It controls the process of 

- priority tasks 

- real-time messages 

- time dependent (periodic) tasks 

- background tasks. 



Inputs 

EX receives two real-time messages from any debug modul e» 'start 
message extraction' and 'stop message extraction'. 

Format ’ 



RMN : 


EX 




SMN : 


any 


debug module 


mm : 


1 0 


- start 




1 1 


- stop 


ML : 


04 





This message controls the state of the flag MSGEX TR AC T I ON . 
It is set to 'TRUE' upon receipt of the 'start message 
extraction' message and reset to 'FALSE' when 'stop message 
extraction' is received. 



Func t ion 

System Initialization 

The system is initialized with a call of procedure EXSTART 
at system start. Prior to this call the variables SAVESTACKPTR 
and RESTART are set. 

SAVESTACKPTR contains the value of the stack pointer at initial 
system start. It is saved for a system restart without loading 
and system RESET. 

RESTART is set to 'FALSE' at the initial start of the system. 

In case a system restart is initiated with I N T 6 r RESTART is set 
to 'TRUE'. At the same time trie stack pointer is reset to the 
saved value. 

RESTART is used by all modules to determine whether the current 
start is a system start with or without hardware reset. 
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In order to prevent over 1 acpi nq proaram action c ausea by 
erroneous interrupts* the i nt or runt s are locked out for the 
time of system initialization. 

All system tables are reset and a ’start* messaae for each 
module in the same SBC is packed into the system’s message 
buffer. 

EXSTART ends with the initialization of the interrupt control- 
ler and an ENABLE instruction. 

SBC 1 has additional tasks at system initialization. It resets 
the R T C # starts the RTC ucdate and gives the start signal 
to all other SBCs in the system. 

All other modules in the system check their specific start 
variable STARTl# START,? etc. to take on a value other than 0. 
After completion of the initialization# SBC1 sets the respective 
SBC number into STARTl# STARTS etc. and all SBCs start their 
i n i t i a 1 i z a t i o n . 



Priority Calls 

In the context of priority calls there are two relevant 
items of system data: PRIORLIST and PR I ORSCHEDULE . 

PRIORLIST is an address vector of length 8 and contains the 
addresses of priority procedures entered. 

PRIORSCHEDULE is a byte variable which indicates the scheduled 
priority calls#e.g. bit 0 = 1 means that a priority call of 
the priority procedure in PRIORLIST(O) has been scheduled. 
Prior to the call of this procedure the respective bit in 
PRIORSCHEDULE is reset to 0. 

The executive keeos checking PRIORSCHEDULE until all calls 
have been made before proceeding to the process of real-time 
messaqes • 

Communication Between Modules 

Communication between modules uses real-time messages. 

These messages can be sent from any module to any other module 
in the system. 

A message is considered to be ’internal* if it is sent to a 
module in the same SBC. An ’external* message is sent to a 
module in an other SBC. 

Internal and external messages have the same format #onl y the 
treatment by the executive is different. 
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A messaae is sent with a call of SEND. In this system procedure 
the messaae is placed into MSGBUFFER, a circular FIFO list, 

MSGBUFFER is controlled by two Pointers: M3GIN (next to fill) 
and MSGOUT (next to process). 

The variable N U M M S G contains the number of messages currently 
in MSGBUFFER. 



1 Internal 

The executive checks NUMMSG for a message to be processed. 

If NUMMSG = 0 then the executive proceeds to check for external 
messages . 

MSGOUT points to the next message to be processed. 

The executive computes the index of the next message in 
MSGBUFFER (new MSGOUT = MSGOUT + ML 0 f current message). 

After this update* tne executive examines R M N of the message. 

If the receiving module is in the same SBC the procedure 
MSGENTxx is called (xx - relative module number in 
a SBC : 0 - 7) . 

This procedure is the message entry of the receiving module. 



2 Ext erna 1 

If the receiving module of a message is not in the own SBC, 
the executive calls SENDEXT to process this message. 

There is a buffer for external messages (EXTMSGBUFFER) which 
has a very similar structure to MSGBUFFER. 

The only exception is that the receiver of the messaqe 
is the number of the SBC which hosts the receiving module. 

An external message is kept into EXT MSGBUFFER until it is 
processed by the respective SBC and transferred into the local 
message bu f f e r . 

Since all SBCs operate in EXTMSGBUFFER there is a lock mecha- 
nism that prevents two SBCs from working in EXTMSGBUFFER at 
the same time. 

Every time a message is taken out of EXTMSGBUFFER or when the 
first message is written into the empty EXTMSGBUFFER the vari- 
able EXTMSG is set to the number of the receiving SBC of the 
message currently at the top of EXTMSGBUFFER. 

If EXTMSG = 0 then no external message is waiting to be 
processed . 

After checking the external messages PRIORSCHEDULE is examined 
again. 
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Periodic Calls 



All activated periodic calls are kept in P E R L I S T . 

PERLIST is a vector of records. 

The variable N U M P E R contains the number of activated periodic 
cal Is. 

PERXIBL, a list of pointers to PERLIST, is always kept 
compact, i.e. if a periodic call is s u snended , e n t r i e s in PERXTBL 
are moved to become compact again. This technique reduces 
execution time when the executive is checking for necessary 
pe r i od i c c a 1 1 s . 

If the executive finds a 'next call time* < - RTC then a new 
'next call time* is computed (RTC t time interval) and the 
periodic procedure is called. 

If no periodic procedure is to be called, the executive proceeds 
to the background tasks. 

Otherwise the periodic procedure is called and upon return of 
program control the priority calls are checked again. 



Background Tasks 

Background tasks represent the lowest priority level within 
the executive. 

They are executed only if no other task is pending, i.e. the 
processor is idling. 



Message Extraction 

Before processing a real-time message, the executive calls 
EXMSGEXTR if the flag MSGEX TRAC T ION is 'TRUE'. 

In this procedure the current message is checked against 
the message control bloc* contained in DEBUG MCB. 

If DEBUG MCB matches the current message, the message entry 
of the debug module is called with a faked 'message extrac- 
tion' message. 

Upon return the current message is processed. 
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Output s 



At system start ; after its own initial i z a t 1 o n * EX sends 
’start* messages to all moaules in the same SBC. 

Format : 

R M N - all modules in own SBC 
SMN - EX 
MN - 00 

ml - oa 

Apart from the 'start* message* EX sends an 'extraction* 
message to DB if message extraction is activated and a match- 
ing message was detected. This message is 'sent' by directly 
calling the message entry of DB. 

This special Procedure is chosen in order to avoid an ex- 
cessive load of the system's message buffer since each ex- 
tracted message would be represented twice: as original 

message and as data bytes of the 'extraction' messaae. 



Interrupt Handling 

All interrupts are handled entirely by the operating system. 

There are four system interrupts and three user interrupts. 
The system interrupts are: 

- RTC interrupt 

- CDC interrupt 

- system restart 

- enter monitor. 

The RTC interrupt (I NT?) is activated in SBC 1 only. 

This interrupt is generated by counter 0 of the interval 
timer arriving at the terminal count of 0. 

Counter 0 is first set in procedure EXSTART to the equiva- 
lent of 1 msec and started. 

Upon occurrence of the interrupt the RTC is undated ana the 
counter is started again with a time interval of 1 msec. 

A CDC interrupt may be initiated in each SBC. The CDC inter- 
rupt is started with the system call SETCDC. 

At terminal count the interrupt (INTO) is generated and 
the address passed with the system call is called. 

The system can be restartec without RESET by generating 
INT6 at the front panel of the MDS. From the interrupt 
process the procedure SYSREST ART is called where the restart 
is initiated. 
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The SBC monitor can be entered at any time by pressing I N T B 
at the front panel. 

This interrupt is jumpered on the SBCs to cause an interrupt 
on level 1 . 

Upon occurrence/ the monitor is entered at location 0740H. 

The same procedure when activating the monitor with RESET 
applies/ i.e. typing capital 'U' to initialize the USART. 

Note: Since the monitor changes locations in on-board Random 
Access Memory/ the system cannot be restarted without 
loading! 

User interrupts can be activated on levels 3/4 and 5. They are 
activated and oe-activated with system calls (ENTERINT and 
REMIND . 

The interrupt vector is located at 3000H and has a length of 
64 bytes/ i.e. each interrupt occupies 8 bytes. 

This structure is compatible with PL/M-80. 

The interrupt routines are written in PL/M-80 and therefore 
located at 0000 - 003FH. 

After SBC 1 is loaded/ the loader transfers the code for 
interrupt processing to its final location in the interrupt 
vector. 

Since the user interrupts are restricted by PL/M-80 to 
INT3 - INT7/ only 5 interrupts can be programmed this way. 
These are the three user interrupts and RTC and COC interrupt. 
The code for the process of monitor and restart interrupt is 
written into the interrupt vector in procedure EXSTART. 

The book-keeping of user activated interrupts takes place in 
table INTTBL. 

INTTBL(i) contains FFH if interrupt i is not activated. 

An activated interrupt is indicated by INTTBL(j) = k, where 
j is the interrupt level and k is the index of the priority 
task to be scheduled upon occurrence of the interrupt. 



System Data 

System data are divided in two parts: 

- data to be compiled with each module 

- data to be compiled with the executive/ system calls 
and the debug module. 

The first data set is in the source files SYDATP.SRC and 
SYDATE .SRC . 

The executive has to be compiled with the PU8LIC declarations 
of this data in SYDATP.SRC whereas all other components of 
the system are compiled with the EXTERNAL declarations in 
SYDATE .SRC . 
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Since this data set is well explained in the program listing 
(see Section 11 in the operating system user's manual) it 
is not described here. 

The second data set is in the source files EXDATP.SRC and 
EXDATE. SRC . 

It contains all data necessary for the operation of the execu- 
tive and the system calls. 

The executive has to be compiled with the PUBLIC declarations 
in EXDATP.SRC. All other components which need to operate on 
these data (system calls, interrupt handling, debug module) can 
be compiled with the EXTERNAL declarations in EXDATE. SRC. 

All operational data of the system are listed and described 
in Section 9. 



System Calls 

The code of the system calls has been split up into seven 
parts in order to ease program development and maintenance 
under ISIS — I I . These program parts are named SCPUB1 - SCPUB7. 

The object code of the system calls is kept in the object 
library SC. LIB. 

Each module can be comp ilea with the set of EXTERNAL decla- 
rations of all system calls in the source file SCEXT.SRC. 

The matching of the PUBLIC and EXTERNAL declarations takes 
place in the LINK step during system generation where the 
object library SC. LIB has to be included. 

The function of the system calls is explained in the source 
program 1 i sting. 
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Real-time Clock and Count Down Clock 



RTC and CDC are implementea using counter 0 and 1 of the 
on-board interval timer. 

Both counters are ’down counters’ with a terminal count of 0 
and driven by a clock inout of 1.8o micro seconds. 

The ’terminal count* output line is jumoered to the interrupt 
control 1 e r . 

Counter 0 generates a level 2 interrupt while counter 1 is 
tied to INTO. 

Counter 0 (RTC) is driven by SBC 1 only. SBC 1 loads counter 0 
with the equivalent of 1 msec (LSB = 1.86 micro seconds) and 

updates the RTC (4 byte vector in common memory) by 1 upon 
occurrence of the interrupt, i.e. terminal count of counter 0. 

A CDC interrupt is implemented in each SBC. Its initialization 
is by a system call (SETCDC). 

In the process of this system call the following actions take 
place: 

- save the address to be called at CDC interrupt 

- enable interrupt level 0 

- load counter 1 with the transferred value 
(LSB = 1.86 micro seconds). 

Upon occurrence of the CDC interrupt, the interrupt on level 0 
is disabled and the indicated address is called. 
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Loader 



The system is loaded and started under control of a separate 
loader* 



The loader runs in the MDS and is started together with the 
SBCs. It interacts with the SBCs through four absolutely located, 
variables: 



LOADSBC 


(F1F0H) 


STARTl 


( F 1 F 1 H ) 


STAR T2 


(F If 2H) 


STARTS 


(F 1F3H) 


four variables are 



At start all four variables are reset to 0 . The SBCs conti- 
nuously check LOADSbC to take on the value of their SBC number 



( 1 - 3 ) * 

The loader loads the code for SBC1 from the disk with an 
offset(bias) of 6000H.An ISIS-II system call is used to load 
the file LOAD 1 . 

After completion of the loading LOADSBC is set to 1 • T h e loa- 
der now waits until LOADSBC becomes 0 again. 



SBC1 detects the *1' in LOADSBC and starts moving the code 
from the temporary storage into on-board memory for which it 
was located before by the LOCATE program of ISIS-II* 

After completion of the mover LOADSBC is set to 0 and then the 
SBC waits for the variable STARTl to become 1. 



The loader now repeats the process for SBC2 and SBC3. 

After having loaded all SBCsr the loader stores a 1 in STARTl. 
This is the signal for SBC1 to start. 

After initializing system oata and the RTC the variables 
STARTS and STARTi are set to 2 and 3 respectively. 

This effects the start of the entire system. 

The loader issues informative messaaes on the CRT as it 
proceeds through the loading process. 

It should be noted that a loading process is not necessary 
in a practical apol i cat i on because the program would reside 
in Read Only Memory. 
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Memory Map 



In this section all absolutely located data and code is des* 
criDed. Furthermore all PRUM changes of the SBC monitor are 
I i s t e d . 



Absolute Data 

Absolutely located data is necessary for communication between 
SBCs and loading and starting of the SBCs. 

Absolute system data are located in the region F000H - F1EFH. 
These data include: 

- module status table (MODSTATUS) 

- real-time clock (RTC) 

- message buffer and message control variables for 



external 


messaae exchanqe. 




F 0 0 0 






• • 


MODSTATUS 




F 0 1 7 






F 0 1 8 






• • 


RTC 




F01B 






FO 1C 


EXT MSGLOCK 




F01D 


E X T MSG 




FOIE 


EX TMSGIN 




FO 1 F 


EX TMSGOUT 




F 020 


NUMEX f MSG 




F 02 1 


E X TL AS 1 MSG 




F 022 






• + 


EXTMSGBUFFER 




F 1 19 






Absolute data for 


loading and starting are 


1 oc a t ed 


region FIFO - F 1 F 7 






FIFO 


LOADSBC 




F IF 1 


START 1 




F 1F2 


START2 




F 1 F 3 


START3 




F 1F4 






• • 


key for the system operation (k< 


F 1 F 5 






Since the snapshot 


function is implemented 


with the 


i ns t rue t i on RS I 4 , 


it is necessary to define 


the 



entrance of the snapshot execution in an absolute location. 
Ihe entry address is stored in 3 0 *1 0 H and 3 0 4 1 H . 
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Absolute Code 



Apart from the code for the SBC monitor, which is located 
absolutely because it resices in ROM, the interrupt vector 
has to be located absolutely. 

Ihe interrupt controller is programmed to expect the interrupt 
vector at 3000H with b by tes/i nterrupt . 

Ihe code for IhlU,lNTcJfIfoI3,INF4 and INIS is moved into the 
vector by the loader. Ihe rest of the vector is set in the 
start routine (ExSIARI). These are INTI (entry of monitor) and 
INT6 (system restart). 

INT7 currently is not implemented. 



3000 






3007 

3008 


C DC 


i nterrupt 


. . 

300F 

3010 


'enter SBC monitor' interrupt 


. . 

3017 

3018 


R 1 C 


i nterruot 


30 IF 
3020 


INI 3 


(user interrupt) 


. . 

302 7 
3 028 


INTO 


(user interrupt) 


302F 

3030 


I N T 5 


(user interrupt) 


. . 

3037 
3 0 38 


'system restart' interrupt 


. . 

303F 


INT 7 


(not implemented) 
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Changes of the SBC Monitor 

This section lists and comments the changes of the SBC moni- 
tor in PROM* 

The monitor needs to be modified in order to allow the 
automatic loading of the system. 

At system start the monitor checks a key which is an address 
value located in F 1 F 4 H . 

For operation of operating system the user has to store the 
the hexadecimal value ABCD in this location. If the contents is 
different from this value the monitor will operate in normal 
mode . 



0000 


JMP 


0/00 




C 3 


00 


07 j unrio to 0700H at R t S fi I 


0 700 


L X I 


H,KEY 


21 


F 4 


F 1 


check key 


0703 


MV 1 


A, 0ABH 


3E 


AB 






070b 


CMP 


M 


BE 








0 706 


JN2 


0740 


C2 


40 


07 


start monitor 


0709 


I IV X 


H 


23 








0 7 0 A 


MV I 


A,0CDH 


3E 


CO 






0 7 0C 


CMP 


M 


BE 








070D 


J N L 


0740 


C 2 


4 0 


07 


start monitor 


0710 


D I 




F 3 






disable interrupts 


071 1 


LXI 


H , LOADSBC 


21 


F0 


FI 


wait until ready to load 


0714 


MV I 


A, SBC 


3E 


nn 




SBC nn 


07 16 


CMP 


M 


BE 








071 / 


J NZ 


07 16 


C 2 


16 


07 


not ready yet 


0 7 1 A 


LXI 


B,9000 


0 1 


00 


90 


begin of temporary code 


0 7 iu 


LXI 


0,3042 


1 1 


42 


30 


begin on-board RAM 


0 720 


LDAX 


, B 


0A 








0721 


STAX 


; B 


12 






move code into own RAM 


0722 


I NX 


B 


03 








0723 


INX 


D 


13 








0724 


MV I 


A, 0EFH 


3E 


EF 




last byte to be moved 


0726 


CMP 


C 


B9 








0727 


JNC 


0720 


02 


20 


07 


c on t i nue move 


0 72 A 


MV I 


A , 0 


3E 


00 






0 72C 


STA 


LOADSBC 


32 


F0 


FI 


reset LOADSBC 


072F 


LXI 


H,STARTn 


21 


F n 


F 1 


check for start SBC n 


0732 


MV I 


A , 0 


3E 


00 






0734 


CMP 


M 


BE 








073b 


J L 0 7 34 


CA 


34 


07 


no st art yet 


0 736 


STA 


ST ART n 


32 


F n 


F 1 


reset STARTn 


0736 


JMP 


3042 


C 3 


42 


30 


start SBC 


0740 


MV I 


A , 4 E 


3E 


4 E 




replaced monitor 


0742 


OUT 


ED 


03 


ED 




instructions 


0 744 


JMP 


I MUST 


C 3 


OH 


03 


0000 - 0006 



15 



57 



0020 


D I 




F 3 


0021 


PUSH 


H 


£5 


0022 


PUSH 


0 


05 


0023 


PUSH 


B 


C5 


002a 


PUSH 


PS to 


F5 


0025 


lhld 


3oaoH 


2 A 


0028 


PC HL 




E9 



execute snapshot 
upon execution of 
a RST4 instruction 

save reqisters 

40 30 address of snapshot 
transfer control 
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Listing of 



txecut ive 



Data 
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R PRIORITY TRSK IS CALLED WHEN IT IS SCHEDULED BY 
SETTING THE RESPECTIVE BIT IN PRIORSCHEDULE, 

E. G. IF BIT 3: < LSB = BIT GO IN PRIORSCHEDULE IS 
SET, THE ADDRESS IN PRI0RLIST<3> IS CALLED. 
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I nt roduc t i on 

This manual describes the use of the real~time operating system 
for dedicated multi processor micro computers. 

The operating system is designed to use INTEL’S single board 
computers SBC80/20-a , t heref ore it is assumed that the reader 
is familiar with 

- single board computer hardware 

- PL/M-80 

- operating system ISIS-II for INTEL'S MDS. 



Abbreviations and Conventions 

All numbers in this segment of text are decimal except as 
otherwise indicated. 



Task - part of the program which handles a specific 

function of the system and consists of one or 
more procedures 



Module - part of the program which consists of one or more 
(related) tasks and can be compiled separately 



Execut i ve 



part of the operating system which contols the 
scheduling and execution of tasks 



Ope ra t i ng 
System 



consists of execut i ve» system cal 



s and system data 



System 



consists of operating system and all integrated 
user modules 



SBC - Single Board Computer 



MDS - Microcomputer Development System ( INTEL) 

MCB - Message Control Block 
RMN - Receiving Module Number 
SMN - Sending Module Number 
MN - Message Number 
ML - Message Length 



EX 

LP 

CS 

DB 



executive, module 
line printer modu 1 e , modu 1 e 
CRT module, module 
debug module, module 



numbe r 
number 
number 
numbe r 



in SBC 
in SBC 
in SBC 
i n SBC 



1 / 2/3 
1/2/3 
1 /i/3 
1/2/3 



00 / 08/1 & 
05 / 13/21 

06 / 1 a /22 

07 / 15/23 



RTC - Real Time Clock 
CDC - Count Down Clock 
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Facilities of the Uoerat inc System 

The operating system is specifically designed to control 
complex real-time environments. 

In order to meet these requirements the operating system 
provides: 

- priority task schedul inn 

- communication between modules 

- time dependent (periodic) scheduling of tasks 

- real-time clock and count down clock 

- system monitor 

- commonly needed functions in form of system calls 

- interrupt handlina. 

The operating system is able to control all possible SBC hard- 
ware configurations. INTEL’S multibus system can handle up to 
lb master control ler, theoretical ly all SBCs. 

Code in memory may be shared by several SBCs, however, care 
should be taken that there is no interference with data access. 

By simply keeping all data in on-board memory no data conflicts 
can occur . 

For efficiency reasons the executive and time critical func- 
tions should be kept in on-board memory, whereas the code of 
the system calls can be located in common memory where it can 
be shared. 

A module can take on the identities of several modules. 

The body of the module is shared in common memory. The kernel 
of the module, i.e. the entry for real-time message, is special in 
each SBC as expressed by different module numbers. 

Communication between modules allow the sending of messages 
from a module to another module, regardless of where these 
modules are located. 

Since messaqe between SBCs as well as code executed from common 
memory make use of the system bus the actual distribution of 
the modules in the entire computer system should be such that 
system bus access is minimized. 

All executives in the SBCs are identical, the binding of an 
executive to the host SBC takes place during the compile with 
two compile oaremeters: number of SBC and module number of 

first module in the SBC. 
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System Organization 
Modular Structure 



The operating system supports a strictly modular structure. 
Modules are integral Parts of the overall system which usu- 
ally handle a specific task or a group of related tasks. 
This organization not only eases program Development and 
maintenance it also allows e as y - t o- i mp 1 emen t changes of the 
system. 



The links between a module and the. rest of the system are 
the system data and the entry for real-time messages of the 
modu 1 e . 

These links requ i re 

- the inclusion of system data in the compilation of a 
module 



- the marking of the message entry procedure as a PUBLIC 
procedure and a predefined name to allow access by 
the executive. 

The example of a complete user module is given in Section 9. 



A module has a unique number which is used to identify it 
in the system . 

The number of a module depends on the number of the SBC which 
hosts the module. Each SBC can have a maximum of 8 modules 
(0-7), e.g. module 3 in SBC 2 . has the module number 11. 

The lowest module number in each SBC is reserved for the 
executive. Implementing the executive as a module allows 
user modules to send message to the executive. 



Each possible module in the system has a reserved byte 
in the system table MODSTATUS. This table contains the status 
of all modules. If the entry is 0 for a module the module 
is not existent. 

MODSTATUS is updated with the system call UPDSTAT 
(see Section 6.12). 

Each module is in one of three states: nonexistent* existent 
or activated. 
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Priority Tasks 



Priority tasks consists of one or more procedures w i t h one 
entry procedure. The call of this procedure can oe scheduled. 

A scheduled priority task will be considered by the execu- 
tive as soon as the processor becomes available. 

Usually the process of an interrupt is implemented as a priority 
task where the scheduling is done in the interrupt procedure. 

In connection with priority tasks there are four related 
system calls: PRIURITY, PRIORITYINT, EN T ERPR I OR and REMPRIOR 
(see Section 6 for formats). 

A priority task has to be entered into the list of priority 
calls prior to its first scheduling. This is done with the 
system call ENTERPRIOR. EN1ERPRI0R returns an inaex which is 
used to schedule a call of the task (PRIORITY or PRIORITYINT) 
or remove the task from the priority list (REMPRIOR). 

PRIORITYINT and PRIORITY perform the same function, however, 
PRIORITY may not be called from an interrupt procedure and 
vice versa. This prevents erroneous program action in the 
case that the processor is interrupted while executing the 
priority scheduling system call. 
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Communication Between Modules 



Since modules are separate and independent parts of the 
system/ the ooeratinq system has to provide a function which 
allows the modules to communicate with each other. 

This communication takes place in form of a messaqe exchanqe. 
Messages are sent and received oy modules and the sender 
and receiver are identifieo by their module numbers. 



A message consists of a 
necessary/ data bytes. 
The MCB has a length of 

*********** 

* RMN * 

* SMN * 

*********** 

* MN * 

*********** 

* ML * 

*********** 



message control block (MCB) ana* if 
4 bytes and the following structure: 

Receiving Module Number 
Sending Module Number 
Message Number 
Message Length 



The MN is an agreed upon number between sender and receiver 

of the message in order to identify the meaning of the message. 

ML determines the total number of bytes of the message 

(MCB + data bytes) and has a minimum value of 4 (message without 

data bytes). 



A message is sent with the system call SEND. This routine requires 
the address of the first byte of the MCB to be passed to it. 

SEND returns a 'TRUE 1 if the message has been sent and a 'FALSE* 
otherwise. The latter can happen when the receiving module is 
not activated or not existent. 

If the message has been sent# data bytes may be stored in the vec- 
tor MSGDATA. SEND has reserved space for as many data bytes as 
indicated by ML in the MCB. 

In the case that more data bytes than specified are written 
into MSGDATA they will be disregarded. 

The message is inserted into a circular FIFO list. 

The executive checks the top of the list and transfers control 
to the message entry of the module specified by RMN in the MCB. 
Prior to calling the module the message to be processed is set 
into the vectors MSG and MSGDATA to allow access by the pro- 
cessing modu 1 e • 
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Time Dependent (Periodic) Scheduling of Tasks 

A common requirement of real-time aopl icat ions is the time 
dependent execution of tasks, e.g. a display has to be up- 
dated every two seconds or a process has to be trigaered 
once after a certain amount of time has elapsed. 

Ihe operating system provides the functions for executing 
tasks of this kind. 

The time dependent scheduling of tasks is implemented with 
three system calls: PERACT, PERCHG and PERSUSP (see Section 6 
for formats). 

A procedure can be entered into the list of periodic tasks 
by calling PERACT and passing 2 parameters: the address of 

the procedure entry and the time interval. 

PERACT returns an index which identifies the task in the 
system calls PERCHG and PERSUSP. 

The time interval can be changed with the system call PERCHG 
and a periodic task can be removed from the list with a call 
of PERSUSP. 

The executive conti nousl y checks the list of periodic tasks 
and calls the respective procedure when the specified time 
is less than or equal to the value in the real-time clock. 



Background Tasks 

In order to utilize the processor in case that no prio- 
rity call is scheduled, no message is to be to processed and no 
periodic call is necessary, background tasks can be called 
by the executive. 

Typically, not time dependent hardware checks are performed 
as a background tasks on a time slice basis. 



Interrupt Handling 

All interrupts are handled by the operating system. 

User interrupts currently can be activated on three levels: 

I NT 3 , INT4 and INT5. 

An interrupt is activated with the system call ENTERINT. 
Parameters for this system call are the requested interrupt 
level and the index of the priority task to be scheduled upon 
occurrence of the interrupt. 

An activated interrupt can be de-act i vated with the system call 
REMINT. 
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System Data 

The set of EXTERNAL system data declarations as listed in 
Section 11 has to be incluaed in the compilation of a module. 
The PUBLIC definitions of the same data are compiled to- 
gether with the executive. 

Care should be taken in the use of the system work variables. 
Since all modules are allowed to use them (except in interrupt 
routines) their contents is not preserved from one call 
to the next. 



Execut i ve 

This section describes the function of the executive and 
the interface between executive and user module. 

The executive of the operating system is a program 
1 oob which checks for pending tasks on 4 levels: 

- priority tasks 

- messages to be processed 

- periodic tasks 

- background tasks. 

The executive only proceeds to the next lower level if no 
task is pending at the current or a higher level. 

The only link between the executive and a user module is the 
message entry of the module. 

The executive is compiled with all possible message entries 
declared as EXTERNAL Procedures while the respective PUBLIC 
declaration is part of the module. 

During the linking orocess of ISIS-II the two declarations 
are matched and the ececutive can call the message entry of 
the module at system start. It is up to the module to initi- 
alize itself/ enter priority calls/ activate periodic calls 
and set its own status. 

Prior to calling a module's message entry/ the executive 'sets' 
the message into the based vectors MSG and M S G D A T A where MSG 
contains the MC8 and MSGOATA the data bytes/ if any. 

Each SBC runs its own/ identical executive. The only 
difference between the ececutives is the module number. 



?6 



9 



System Calls 



This section describes format and function of the system 
cal Is. 

All system calls are qiven in the form 

NAME. TYPE (oarameter list). 

A TYPE included after the name means that the system call 
returns a value of the indicated type. 

An/Bn in the oarameter list indicate address/byte values. 
ENIERPRIOP 



Format t 


ENTERPRIOR BYTE (Al) 


Input : 


A1 - address of priority Procedure 


Output I 


• index of the nr i or i ty task 

(may be used for scheduling and removinq the 
task) 

. FF if the task could not be entered into the 
list of priority tasks (overflow) 


Function : 


The indicated priority procedure is entered into 
the list of priority tasks. The index to this list 
is returned. The list can hold up to 8 tasks/SBC. 



PRIURITYINT/PRIORI FY 



Forma t : 


PRIORI I YINT/PRIORITY (61) 
* 


Input I 


B1 - index of priority task 


Function : 


A single call of the indicated priority proce- 
dure is initiated by the executive. The call 
occurs as soon as the CPU becomes available. 


Remarks : 


PRIORI TYINF is to be called from interrupt proce- 
dures only and PRIORITY is not to be called f rom 
interrupt procedures! 

Prior to scheduling a priority task it has to be 
entered with ENTERPRIOR/ otherwise erroneous pro- 
gram action will occur. 



10 



77 



REMPRIOR 



Format 
I npu t 
Function 

SEND 

Format : 
Input : 

Output : 

Function : 



PERACT 
Format : 
Input : 

Output : 

Function : 
Remark : 



REMPRIOR (81) 

til - index of priority task 

The indicated priority task is removed from the 
list of priority tasks and can no longer be 
schedu 1 ed . 



SEND BYTE (Al) 

A1 - address of first byte of MCB 

TRUE if message sent 
FALSE otherwise 

MSGDATA is set to contain the data bytes of the 
message . 

A message is sent to another module with this 
system call. 

If the outout is TRUE the message is sent and the 
data bytes can be written into MSGDATA, if any. 

If the output is FALSE the message could not be sent 
This may be caused by a not activated receiving 
module or an overflow in the system’s message buffer 



PERACT BYTE (A1,A2) 



A 1 


- address 


o f 


entry 


procedure for 


pe r i od i c 


task 


A2 


- address 


o f 


first 


byte 


of time 


i nt erva 1 






(The time i 


nterval is 


e xpec t ed 


to be in 


RIC 



format.) 

. index of periodic task 

. FF if task could not be activated because of an 
overflow in the list 

The call of the indicated periodic task is activa- 
ted with the inout time interval. 

The task is called as soon as possible and from 
then on with the time given interval. 
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PERCHG 



Format 


PERCHG (B1,A1) 


Input 


B1 - index of periodic task 

A1 - address of first byte of time interval (in KTC 
f o rmat ) 


Func t ion 


The time interval of the periodic task is changed. 


Remark 


The periodic task is called next at RTC i new 
time interval. 


PERSUSP 

Format 


PERSUSP (Bl) 


I nput 


B1 - index of periodic task 


Func t i on 


The periodic task is removed from the list of per- 
iodic tasks ana is not called any more. 


ACTIVATE 

Format 


: ACTIVATE BYTE (81,82) 


Input 


: 81 - number of module to be activated 

B2 - number of calling module 


Output 


: FALSE if module to be activated does not exist or 

calling module not authorized 
TRUE ot he rw i se 


Func t i on : 


: The indicated module is to be activated. 

The module receives a 'restart' message to indicate 
that it has to reinitialize itself. 


ACTIVE 

Format 


ACTIVE BYTE (Bl) 


I nput 


Bl - module number 


Output 


TRUE if the indicated module is active 
FALSE otherwise 


F unc t i on : 


: The system call checks the status of the input 

module and returns a TRUE if the module is active. 
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SUSPEND 



Format : 
Input • 

Outout : 

Function : 

PROC ADR 
Format : 
Output : 
Function : 

Remark : 



SUSPEND BYTE (B1,BP) 

B1 - number of module to be suspended 
BP - number of Calling module 

FALSE if the module cannot be suspended of* calling 
module not authorized 
TRUE otherwise 

The indicated module receives a ‘suspend* message. 
Its status is changed from 'active* to 'existent'. 



PROCADR ADDRESS 

first address of calling procedure 

This system call is used to determine the location 
of a procedure at run time. 

Since PROCADR examines the system stack, it only 
returns a correct value if called with the 
following sequence of code: 

X YZ : PROCEDURE; 

IF FLAG = 0 THEN 
DO; 

XYZADR = PROCADR; 

FLAG = l; 

return; 

end; 



procedure body 

• • 

END XYZ; 
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UPDSTAT 



Format 
I nput 



Function : 
Remark : 

cleardata 
F ormat : 
Input : 

Func t i on : 

BIT 

Format : 
I npu t : 

Output : 

CLEARBIT 
Format : 
Input : 

Function : 



UPDSTAT ( B 1 , b? ) 



B 1 
B2 



module 
status 
pit 0 : 

bit 1 : 

bit 2 : 

bit 3 : 



number 

0 - module does not exist 

1 - module exists 

0 - module not acticated 

1 - module activated 

0 - module may not be suspended 

1 - module may be suspended 

0 - module not authorized to 

suspend/ ac t i va t e others 

1 - module authorized to suspend/ 

activate others 



The current status of module B1 is replaced by B2. 

The status of a module has to be set when the 
module receives the 'start' message in order to 
change its status from 'not existent' to 'exis- 
tent' or 'activated'. 



CLEARDATA (A1,A2) 

A 1 - address of first byte 
A 2 - address of last byte 

Clear data from A1 to A2. 



BIT BYTE ( B 1 , B2 ) 

B1 - number of bit 
82 - byte to be checked 

TRUE if bit B1 in B2 is set 
FALSE otherwise 



CLEARBIT ( B 1 / A 1 ) 

81 - number of bit 

A1 - address of a memory location 

Bit 81 in memory location A1 is set to 0 . 

- la - 
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SETBI T 



Format : 
Input : 

Function : 

SEICDC 
Format • 
Input : 

Out Put : 

ILLEGAIMSG 
Format : 
Function : 

ENTERINT 
Format : 
Input : 

Output : 

Function : 

REMINT 
Format : 
Input : 
Function : 



S E T 8 I T (81, Al) 

B1 - number of bit 

A1 - address of memory location 

bit Bl in memory location A1 is set to 1. 



SETCDC BYTE (A1,A2) 

A 1 - time interval (LS8 = 1.86 micro sec) 
A2 - address to be called at CDC interrupt 

FALSE if CDC already activated 
T RUE otherwise 



ILLEGAIMSG 

Process undefined message for a module. 

An asynchronous messaqe giving the MCB of the unde- 
fined messaqe is initiated at the CRT. 

The undefined message is taken out of common vector 
MSG. 



ENTERINT BYTE (Bl,B2) 

Bl - interrupt level 

82 - index of priority task 

FALSE if same interrupt already occupied 
TRUE otherwise 

The interrupt on level Bl is enabled. 

Upon occurrence of the interrupt the call of priority 
task with index 82 is scheduled. 



REMINT (Bl) 

Bl - interrupt level 

The enabled interrupt on level Bl is disabled. 
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System Monitor 

The system monitor is implemented as a system call and may be 
called when an internal error condition occurs* program 
limits are exceeded etc. 



The system monitor generates an 'asynchronous output' message 
to a CRT module to indicate nature and location of the special 
condi t ion. 

Format : CALL SYSMON (At,Bl,B2); 

A1 any address value 

B1 and B 2 are any byte values 

The generated asynchronous CRT output has the following format 

*** SYSTEM MONITOR : XXXX YY 11 

where XXXX = (Al) 

YY = (Bl) 

11 = (B^) 



It is recommended to set Al to the stack pointer when calling 
the system monitor. In this case the displayed value XXXX will 
point to the memory location from where the system monitor 
was called. 

Bl and B 2 can be used to further specify the condition. 



Up to now the system monitor is called with Bl representing 
the module number and B 2 a specification within the module. 



Bl B 2 condition 



0 1 internal message buffer overflow 

0 c? priority list overflow 

0 3 periodic list overflow 

0 4 use of illegal periodic index 

0 5 use of illegal priority index 

0 6 external message buffer overflow 

0 7 double occupation of interrupt level 



5 0 line printer output buffer overflow 
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Real-time Clock and Count Down Clock 

The operating sytem provides two system clocks: 

Real-time Clock (RTC): 

The RTC is a Public 4 byte vector. The least significant 
byte is R T C ( 3 ) . 

The value of the least significant bit is 1 millisecond. 
Maximum time value is 4<?94967 sec = 71S8t? min = 1193 hrs 
= approx. 50 days. 

The RFC is located in common memory and updated by SBC 1. 
Count Down Clock (CDC): 

The operating system provides a CDC for each SBC. 

The CDC can be activated by any module with the system 
call SETCDC. 

The CDC has a length of two bytes and the least signifi- 
cant bit is 1.86 micro sec. 
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System Loader and System Start 

The system is started automatically after the loading is 
completed. 

To load and start the system the following steps have to be 
performed: 

- RESET and load ISIS-II 

- enter monitor and change locations F1F4 and FIFE to 
OABH and OCDH respectively 

- RESET and load ISIS-II 

- load and execute the loader by typing ’LOADER' 

- the loader issues informative messaqes as it proceeds in 
the loading process. 

The loader expects the code to be loaded into the SBCs to be in 
the files L0AD1,L0AD2 and LOADS respectively. 

These files are read from a i s k drive 0. 

In case a file cannot be found* a warning message is typed and 
and the loading process continued. 

The loader terminates if file L0AD1 cannot be found because the 
system cannot be started without SBC1 in this configuration. 

(In a general application* however* any number of SBCs can be 
loaded and started in any sequence.) 

It should be noted that in a practical application of 

the operating system the on-board code would reside in ROM. 
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Example of a User Module 



This section describes an example of a typical user module. 

The example is given in form of a source listinq in PL/M-80 
to be compiled under ISIS — I I . 

DEMO: DO; 

$ INCLUDE CFl rSYDATE.SRC) 

/ * include external definitions of system data * / 



/ * 

************************************************************ 
* * 

** DEMO SUBSTITUTIONS 

*/ 

DCL DM LIT ' 0 i ' , / * module number of DEMO * / 



# * 

ENDSU8ST LIT 'O'; 

/* 

************************************************************ 
★ * 

** DEMO VARIABLE DATA 

*/ 

DCL VARDATABEG BYTE, 

(DMPERX,DMPRIORX) BYTE, 

/* storage for DM periodic and priority 
indices*/ 

(DMPERFL,DMPRIORFL) BYTE, 

/* flags controlling execution of DMPER 
and DMPRIOR */ 

(DMPERADR,DMPRIORADR) ADDRESS, 

/* storage for entry addresses of periodic 
and priority procedures * / 



• » 

VARDATAEND BYTE; 
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/* 

************************************************************ 
* * 

** DEMO CONSTANT DATA 

*/ 

OCL DMTIMEINT (a) BYTE INITIAL CO , 0 , 3, 0E8H) , 

/* time interval for OM oeriodic : 4 sec */ 

DMMSG (4) BYTE INITIAL (4, DM, 10, 7), 

/* MCB for messaae to module U */ 



• • 

DMENDCONST BYTE; 

$INCLUDE( : F 1 : SC EXT. SRC) 

/* include external definitions of system calls */ 



/* 

************************************************************ 
* * 

** DEMO UTILITY ROUTINES 

*/ 

DMUT1: procedure; 

• • 

• • 

END DMUTi; 



DMUTn; PROCEDURE; 

• • 

• • 

END DMUTn; 

/ * 

************************************************************ 

* * 

** DEMO PRIORITY PROCEDURE(S) 

*/ 

DMPRIOR: procedure; 

IF DMPRIORFL = 0 THEN 

/ * first call»find entry address of DMPRIOR * / 
DO; 

D M PR I OR ADR = PROCADP; 

DMPRIORFL = l; 

RETURN; 

end; 



• • 

END DMPRIOR; 
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/* 

*****A**************A****A****A*A**A*********************** 
* * 

* * 

*/ 

DMPER: 



/* 

*********************************************************** 

* * 

** DEMO START PROCEDURE 

*/ 

dmstart: procedure; 

CALL CLEARDAT A ( .VARDATABEG, .VARDATAEND),* 

/* clear variable data */ 

call dmprior; 
call DMPER; 

/* determine entry addresses of procedures */ 

DMPRIORX = ENTERPRIORCDVPRIORADR); 

/* enter priority call of DMPRIOR */ 

DMPERX = PERACT (DMPERADR, .DMTIMEINT (0) ) ; 

/* activate oeriodic call of DMPER */ 

CALL updstat com, 3) ; 

/* set module's status 

3 - existent and activated */ 

IF NOT SEND ( . DMMSG ( 0 ) ) THEN REfURN; 

/ * send demo message to module 4 with data 
bytes 0,1,2 * / 

DO B1 = 0 TO 2; 

MSGDATA(Bl) = 61; 

end; 



DEMO PERIODIC PROCEDlJRE(S) 

PROCEDURE; 

IF DMPERFL = 0 THEN 

/* first call, find entry address of DM PER * / 
DO; 

DMPER ADR = PROCADR; 

DMPERFL = l; 

RETURN,* 

end; 



• • 

END DMPER,* 



END DMSTART,* 
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/* 

************************************************************ 
* * 

** DEMO REALTIME MESSAGE ENTRY 

*/ 

MSGEN T 0 3 : PROCEDURE PUBLIC; 

IF MSG(MN) = 0 THEN 

/ * start messaqe * / 

DO; 

CALL DMSTART; 

return; 

END; 



/* process of other defined real-time messaqe */ 



• • 

END MSGENTOi; 
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Listing of System Data 
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DCL RESTART BVTE PUBLIC; 



FALSE IF START WITH SYSTEM RESET 
TRUE IF RESTART WITHOUT SYSTEM RESET 
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SUSPEND MSG, SENT BY EXEC TO MODULE TO BE SUSPENDED 



Listing of External System Call Declarations 
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SEND fi MSG TO ANOTHER MODULE IN THE SYSTEM 
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PI - NUMBER OF MODULE TO BE SUSPENDED 
F*2 - NUMBER OF CALLING MODULE 
SUSPEND RETURNS A BYTE VALUE 
TRUE - OPERATION 0. K. 

FALSE - CALLING MODULE NOT AUTHORIZED 
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Genera 1 



I n t roduc t ion 

The implemented deouq functions are specifically designed 
to ease the debugging of user modules running under the 
control of the real-time operating system without interference 
witn the operation of the system. 

Since the debug module (OBJ is a user module itself# the functions 
are available only if this module is integrated into the system. 

The debug module communicates with the user using the CRT# 
therefore the integration of the CRT module CCS) is also 
necessary . 

If the user wishes to obtain hard copies of the debugging 
results# the line printer module (LP) has to be integrated# too. 

Inputs at the CRT are terminated with the RETURN key. 

The line editing functions of the CS module can be used. 



Abbreviations and Conventions 

All inputs and outputs of the debug functions are in the hexa- 
decimal number system. 

Numbers in this text are decimal# hexadecimal numbers are trailed 
by the letter ' H 1 . 

DB - module identification of debug module 

CS - module identification of CRT module 

LP - module identification of line printer module 

RMN - receiving module number 
SMN - sending module number 

MN - message number 

ML - message length 

MCB - message control block 

MCB consists of 4 bytes: 

RMN 

smn 

MN 

ML 

SBC - single board computer 

hard copy - printer output of debug function 
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Initiation of the Debuq Moae 

The debuq mode is entered with the input of 'Control-0’ at the 
CRT keyboard. The debug mocule, if integrated, responds with 
•DEBUG CPTR:' and expects the input of the number of the SbC 
which the user wishes to debug. 

Depending on the input the following system reactions are 
possible: 

- SBC number not specified: 

A •?' is typed and 'DEBUG CPTR:* is repeated. 

- Requested SBC is not activated: 

'CPTR NOT ACTIVATED, DEBUG TERMINATED’ is typed and the 
debug mode is left. 

- Requested SBC already debugged from another SBC: 

'CPTR ALREADY DEBUGGED , DEBUG TERMINATED’ is typed and the 
debug mode is left. 

- Input accepted: 

The system responds with a new line and the prompt charac- 
ter of the debug function ’>'. 

Now any of the debug commands described in Section 3 may be 
entered. 



Use of the Debug Functions 

In this section the inputs and outputs of all debug functions 
are described. 

Furthermore, some hints for the usage are given. 

In the following description, system outputs are given prefaced 
by: ' SYSTEM OUTPUTS ’ . 

Debug commands are orompteo with '>'. 

If a debug command requires more than 1 input, these commands are 
prompt ed with ' : ' . 

Illegal inputs are reported with the output of ’?'. 



3 



98 



Inspect and Change 



This function allows the display of byte and address values and 
is invoked by 'A' (for address) or * B ’ (for byte). 

The 'C' command allows the change of the address or byte value 
displayed last. 

Address inspection: 

> A XXXXcr ' A X X X X : YYYY 

> ' 

Note: The contents of the address value is displayed 

in the format a user would read it. The internal 
representation in memory is in the reverse byte form. 

Byte inspection: 

>B XXXXcr ' B X X X X : YY 

> • 

Change of contents: 



> A 


XXXXcr 


’ A X X X X 


: YYYY 


> 1 
> 1 


CZZZZcr 


' AXXXX 


: ZZZZ 


>B 


XXXXc r 


’ BXXXX 


: YY 


> 1 


CZZcr 


' BXXXX 


: ZZ 



> ' 



Note: A change command can be repeated/ it always refers 
to the last inspected memory location (address or 
byte) . 

The change command is only legal following an in- 
spect command. 

The input of address values is in user readable 
format and not in internal machine representation. 

Note: If the last command has been 'A'/ 'B' or ' C 1 then the 

input of RETURN only will display the next byte or address 
value. 
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Memory Dump 



With this function the user con display a contiguous portion 
of memory specified by a begin and end address. 

The dump allows the display of either byte or aodress values. 

The range of the dump can be specified in 2 different ways: 

DO X X X X , Z or DBXXXX-YYYY 

where XXXX is the begin address 
YYYY is the end address 

Z is the number of values to be dumped 

Dump of byte values: 

DB X XXX, Zc r 

'BXXXX : V V V V V V VV ... (up to 16 byte values/row) ' 

Dump of address values: 

DAXXXX,Zcr 

'AXXXX : VVVV VVVV V VVV ... (up to 8 address va 1 ues/row) ' 



Snapshot 

This function allows the display ('snapshot') of 

- CPU r eg i s t e r s / f 1 ags 

- up to 16/32 contiguous address /byte memory locations 

- independently specified address or byte memory locations 

before the execution of a specified instruction. 

Furthermorerthe taking of the snapshot can be conditional in 
the sense that a specified memory location has to have a speci- 
fied value at the time of the snapshot. 

The taking of the snapshot and the display of the results do 
not influence the operation of the system. 

The snapshot remains activated until terminated as described 
in Section 4. The function is executed each time the speci- 



f i ed 


snapshot 


instruction is 


execut ed . 




Note: 


Because 


0 f 


the 


snapshot 


method of inserting a 


trap i ns t rue 




t i on it 


i s 


not 


possible 


to activate a snapshot 


i n a ROM 




section 


o f 


the 


program . 
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Input format : 

S XXXX parameter list cr 

where 'S' is the debug command and XXXX the address 
of the first byte of the snapshot instruction. 

Note: If the snaoshot address is not set to the first 

byte of an instruction* an erroneous program 
action may occur . 

The parameter list can be any combination of the 
followina inputs: 

- R 

This parameter requests the display of all CPU 
registers ana flaqs. 

- D 

This parameter specifies a contiguous region in 
memory whose contents at the time of the snapshot 
is to be displayed. The format of the parameter is 
identical to the debuq function 'dump' described 
in Section 3.2. 

The region to be dumped is limited to 10H/20H 
address/byte values. 

- A o r B 

These parameters have the form AXXXX or BXXXX 
and cause the display of address/byte value at 
location XXXX respectively. A maximum of S loca- 
tions* either address or byte* can be soecified. 

- M 

This parameter has the format 
MXXXX-YY 

where XXXX is a byte location in memory and YY the 
specified contents. 

If this condition is set and the contents of XXXX 
is not YY* then the snapshot is not taken. 

This feature allows to check the state of 
the system at a specified iteration of a loop 
(M parameter is the index variable) or to monitor 
the occurence of a specified input to the system. 



- 6 - 



101 



Output format: 



The snaoshot function has no outputs until the specified 
instruction is executed. 

If no parameter was specified in the 'S' command then only 
the standard output occurs: 

•SNAPSHOT AT XXXX : YY YY YY ' 

where XXXX is the snaoshot address and 

YY YY YY is the snaoshot instruction (max i bytes). 

The outDut initiated by the parameters is self-explanatory. 

If during the output Processing of the snapshot results 
another snaoshot occurs/ it will be suppressed . The number 
of suppressed snapshots is tyoed. 
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Message Simulation 

This function allows the generation of r e a ] • t i m e messages and 
is useful to trigqer processes for which the initiating 
module is not integrated or the initiating input is not 
available* 

After the input of the debug command 'MS', the function prompts 
the user for inputs in order to construct the message to be 
simul ated. 

The input format is shown by the following example. 

I nput format : 

>MSc r 

'RMN: ' l7 C r *SMN: 1 8c r ' M N : 1 1 0 c r 1 ML : 1 6c r 
'DATA BYTES: ' lOcr ' : '20c r 
'MSG SENT 

> • 

The above commands would cause the sending of a message 
with the receiving module number 1 7 H , the sending module 
number 8, message number 10H, message length 6 with two data 
bytes 10H and 2 OH , 

The minimum message length is 4 (length of MCB). 

Maximum message length is 2 4 H : MCB and 2 0 H data bytes. 

The input of data bytes is promoted automatically depending 
on the specified message length. The message is sent as soon 
as the input is completed. 

After the prompt symbol reapears the same message can be 
repeated with the input of the RETURN key only. 



In the case of an illegal input during the input of the 
message/ the same (wrong) input is prompted again. 

If the specified message cannot be sent by the system 
because the receiving module is not activated/ then 
'MSG NOT SEND' is typeo. 
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Message Extraction 



This function allows the interception of any specified real-time 
message at any time. 

The user can specify any combination of RMN,SMN,MN ana ML. 

If the specified message is to be processed by the receiving 
module/the message (including data bytes) is typed on the CRT. 

The input/outout formats are illustrated with the following 
example. 

Input format : 

>MX c r 

' R M N : ' 1 7 c r ' S M N : ' 1 0 c r • M N : ' c r 'ML: 'cr 

An input reauest answered with the inout of RETURN only 
has the meaning of ’not specified'. In the above example 
all messages from module 10H to module 1 7H are extracted 
because MM and ML are not specified and can take on every 
value. 

Output format : 

•RMN: 17 SMN : 10 MN: 11 ML: 16 DATA; VV VV 

VV VV 

(up to 16 bytes/line) 



Periodic Inspect/Dump 

This feature repeats the output of an ’inspect’ or 'dump' 
function at maximum system speed and allows therefore a con- 
tinuous 'look' into memory in order to observe changes of vari- 
able s r status bits etc. 

These functions are initiated by the same commands described in 
Section 3.1 and 3.2 with the difference that they are preceded 
by the letter ' P ' (for periodic). 

E x amp 1 es : 

PDBXXXX,ZZcr 

PDAXX XXcr 

Mote: The number of values to be dumped by the periodic dump 

is restricted to 10H/20H address/byte values. 

A larger range is cut down to this maximum length by the 
debug function. 

'Maximum system speed' is ususally determined by the speed of the 
output media. 
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Hard Cony 



This function allows the user to obtain hard copies of the 
debugging results. 

If a hard copy is reques t eo > t he outputs of 

- memory inspection 
• memory dump 

- snapshot 

- message extraction 

- periodic functions 

are directed to the line printer. 

The user may switch at any time between the CRT ana line printer 
output . 

Default output device is the CRT. 

Input format : 

>Hcr 

The first 'H* command switches output to the line printer,the 
next 'H' command switches back to CRT and so forth. 

If output is switched to the line printer,the print head is 
positioned at the top of a new page. 

In case the line printer is not connected properly,an 
asynchronous message 'LINE PRINTER NOT CONNECTED' is typed 
on the CRT and the 'H' command is disregarded. 
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Termination of a Debug Function 

A selected debuo function terminates in 3 different ways: 

a) The function terminates itself after the inspection of a 
memory location. In this case the system shows the 
prompt character *>'• 

b) If a debug function requires more than 1 input or is 
executed periodical I y * it can be terminated with the 
input of •Control*!’ 1 at any time. The system responds 
with the prompt character. 

c) At any time within the debug mode the CRT interruption 
'Control-I* can be used to disconnect the debug module 
from the CRT. In this case* however* not only the currently 
activated debug function is stopped*the debug mode is 
terminated as well. 

The only system reaction is the positioning of the cursor 
to the beginning of a new line. 



Termination of Debug Mode 

The debug mode can be terminated in 2 different ways: 

a) Use of the debug command * T 1 . 

This input can be made when the prompt character is dis- 
played and a regular command is expected. 

The system responds with 'DEBUG TERMINATED' and leaves 
the debug mode. 

b) At any time the procedure decribed in 4 c) can be used. 



- 11 - 



106 



Summary of Debun Commands 
Debug Functions: 

A - inspect address value 

B - inspect byte value 

C - change address or hyte value 

D - memory dump 

H - hardcopy 

MS - message simulation 

MX - message extraction 

P - inspect/dump in periodic mode 

S - snapshot 

T * terminate debug mode 



Other Debug Inputs 
Control-D 
Control-T 
Control - ! 



initiate debug mode 
terminate debug function 

CRT interruption (terminates debug mode) 
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Gene ra 1 



I n t roduc t ion 

The debug module (module i oen t i f i c a t i on : OB) allows the 
debugging of all modules in all single board computers under 
real-time conditions* 

This means that the use of a debua function does not influence 
the operation of the system. 

Since each single board computer has its own kernel of the 
debug module, it is possible that several users debug different 
program parts at the same time. 

There are no special requirements for the integration of DB 
except that at least one CRT module has to be integrated# too. 

The CRT and the line printer are the I/O media of the debug 
module* Real-time messages are used to communicate with the 
respective modules. 



Abbreviations and Conventions 

All numbers in this segment of text are decimal except as 
indicated otherwise. 

SBC - single board computer 

MCB - message control block 
R M N - receiving module number 
SMN - sending module number 
MN - message number 
ML - message length 

CS - CRT module/ module number in SBC 1/2/3 : 06/14/22 

EX - executive# module number in SBC 1/2/3 l 00/08/16 

DB - debug module/ module number in SBC 1/2/3 I 07/15/23 

LP - line printer module# module number in SBC 1/2/3 : 05/13/21 
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Facilities of the Debuq Module 



The debuq module offers the following debug functions under 
real-time conditions: 

- inspection and chanqe of byte and address values 

- memory dump of byte and address values 

- snaoshot with 

• register dump 

• dump of specified single memory locations 

• dump of one contiguous region of memory 

• specified condition 

- message simulation 

- messaqe extraction 

- periodic inspection/dump 

- choice between CRT and line printer output 



Module Organization 

Because of its size the DB module has been split up into 
9 parts in order to ease program development and program main- 
tenance under the ISIS-II operating system. 

The single parts of DB are program modules in the sense of 
PL/M-80 and ISIS-II. 

Each of the 9 parts has a seperate source file while the object 
code is kept in one object library which represents the object 
code of the DB module. 

In the following the parts of DB are described briefly: 

DBM0D1: This Part is the entry for real-time messages in DB. 

It also includes the PUBLIC definitions of all DB data 
and the START procedure. 

DBMUD2: This part processes all input messages from the CRT module. 
It 



- performs the initialization of the debug mode 

- relays debug requests to responsible debug modules 
in other SBC’s if necessary 

- distributes oebug inputs ana messages to the 
respective debug function. 

The program and data organization of DBM0D2 allows easy 
to implement additions to the debug functions. 
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DBM0D3 : 
DBMODa : 
DBM0D5: 
OBMODfe: 
DBM0D7 : 
DBM008: 
DBM0D9 : 



Memory inspection and change 

Memory dump 

Snapshot 

Message simulation and extraction 
System test 
OB utility routines 
OB utility routines 
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Input Real-time Messages 

DB obtains all inputs from the CRT module. 

The format of the debug inputs is described in the user's 
manual for the debug functions. 

In this section the format and contents of all input messaaes 
is described. The respective process can be found in Section 

3.7. 



Start 



RMN 


DB 








SMN 


EX 








MINI 


00 








ML 


oa 








This message informs DB 


that the system 


has been 


started. 


Input Text 


f rom CRT 








RMN 


06 








SMIM 


CS 








MN 


20 








ML 

DATAO- 


depends on 


1 engt h o f i nput 


text 




D A T An ! 


: ASCII i nput 


characters 






This message transmits input text from 


the CRT to 


DB. 



Terminate I/O 



RMN 


: DB 


SMN 


: CS 


MN 


: 22 


ML 


: 04 



This message is received when the CRT interruption input was 
made during activated debug mode. 

Start Debug 



RMN 


: DB 


SMN 


: CS 


MN 


: 23 


ML 


: 04 



This message is received when a 'Control-D' input was legally 
made at the CRT keyboard: a user wishes to activate the 
debug mode. 
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External Start 



RMN : DB 

SMN : DB module in other SBC 

MN : 24 

ML : 05 

DATAO ; number of CS module for debug inputs and outputs 

This message is received when the host SBC is to be debugged from 
anot her SBC . 

DATAO contains the module number of a CS module to communicate 

with. 



Terminate Debug Function 



RMN 


: DB 


SMN 


: CS 


MN 


: 25 


ML 


: 04 



This message informs DB that a 'Control-T' input was made at the 
CRT keyboard. 

With this input the user wishes to terminate the currently 
selected debug function. 



Output Acknowledge 



RMN 

SMN 

MN 

ML 

DATAO 



DB 



CS or LP 

26 

05 

tel 1 bac k 



code 



This message is sent by CS or LR in order to indicate that the 
output requested by DB has been completed. 

The returned acknowledge code is the code sent to CS or LP with 
the 'output with acknowledge' message. 



Message extraction 



RMN : 


DB 






SMN : 


EX 






mn : 


27 






ml : 

DATA - 


depends 


on length of 


extracted message 


DAT An : 


MCB and 


data bytes of 


extracted message 



This message is received when message extraction is activated and 
the executive has intercepted a message specified for extraction. 
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Line Printer not Connected 



RMN 


: DB 


SMN 


: LP 


MN 


: dZ 


ML 


: 04 



This message informs DU that the line printer is not connected to 
the system. 
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Process i nq 



This section describes the function of the debuq facilities 
and the process of the received real-time messaqes. 



Inspect and Chanqe 

The process of this function is contained in DBM0D3 and con- 
sists of 3 procedures: 

D0INSPECT, DBCHANGE and TYPEINSP. 

DBINSPECT is cal led when 

a) a A,B,PA or PB command has been entered at the CRT 

b) RETURN only was entered at the keyboard and the 
last activated function was A, 8 or C 

c) an acknowledge message was received and the last 
command was PA or PB. 

In case a) the address of the memory location is decoded 
from the input message. 

If the input was not legal » the error indication ' ? ' is 
sent to the CRT module. 

If a periodic output was requested/ the cursor is positioned 
at the beginning of the input line and TYPEINSP is called with 
acknowledge request. 

Otherwise TYPEINSP is called with the output followed by 
the prompt character. 

DBCHANGE is called for the execution of the * C * command. 

If the previous input has not been A, B or C/ then the change 
is not legal and an error is indicated. 

Otherwise the new contents is stored and TYPEINSP is called 
to type address and new contents. 

DBCHANGE terminates with the issue of the prompt character. 

TYPEINSP performs the output of the current 'inspect and 
change' address and the respective contents (byte or 
address) . 

Depending on the state of the flag DBTELLBACK this is done 
with or without acknowledqe request. 
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Memo r y Dump 



The memory dump is performed by DBM0D4 and consists of 5 
procedures : 

DBDUMP, DUMPDECODE, INITDUMP, DUMPLINE and DUMP. 

DBDUMP is the entry procedure* From here the respective 
routines to set up/ execute or repeat the dump (in case of 
periodic dump) are called. 

DUMPDECODE determines the mode* byte or address* and the ran ge 
of the dump . 

In case of an illegal input* a looical ‘FALSE* is returned* 
otherwise a ‘TRUE* is returned, 

DUMPDECODE is called from DBDUMP and DBSNAP (see 3.3). 

DUMP is the procedure which actually Performs the dump from 
DUMPBEG to DUMPEND. 

DUMP is called from DBDUMP and SNAPSHOT. 

The procedure keeps calling DUMPLINE until the flag DUMPDONE 
becomes * TRUE * . 

INITDUMP sets up the format of the output line. It packs the 
address of the first value typed on a line and determines 
the number of values typed on a line depending on the mode 
of the dump • 

DUMPLINE packs the contents of the memory locations starting 
at the current address. Up to ENDLINE values are packed for 
a line. DUMPLINE uses the utility procedures PACKBYTE and 
PACKADR to convert the contents of memory locations into 
ASCII codes and pack into DB output buffer. 



Snapshot 

The snapshot function constitutes DBM0D5 and consists 
4 procedures. 

Basically the snapshot is enabled by replacing the operation 
code of the instruction at the snapshot address by the trap 
instruction RST4. The actual snapshot is taken when this 
instruction is executed and an ‘interrupt* occurs. 

The display of the snapshot data is performed with a 
priority call scheduled during the process after the execution 
of the trap instruction. 

The snapshot remains activated until it is terminated by a 
command. At this time the original instruction is restored 
at the snapshot address. 
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If the System is stopped with an activated snapshot and 
started again without new loading, the snapshot address still 
contains the R S T 4 instruction. 

The start procedure of OB checks for an activated snapshot 
before system ston and restores the original instruction 
i f necessary . 

DBSNAP initiates the snapshot and performs the following 
funct ionst 

- reset all relevant snapshot data 

- process CRT input 

. 'R' - set REGFL 

. 'M' - set SNCONDADR to condition address and 

SNCONDSAVE to the condition 
set CONDFL 

. 'O' - determine address and type of dump 

(procedure DUMPDECODE is used) 
set DUMPFL 

. ' A ' / ' B ' - determine address and type of the reques- 

ted variables and store in SNVAR 
update SNVARX (index to SNVAR) 

In case that an illegal input is encountered during 
the process of the CRT input, the display of '?' and the 
prompt character is initiated and proqram control is 
returned. 

- determination of the length of the snapshot instruction 

- insertion of the instruction in the execution table 
SNEXTBL ( see structure of SNEXTBL below) 

- insertion of the address of the next instruction into 
SNEXTBL (= snapshot address + instruction length) 

- insertion of RST4 at the snapshot address 
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Organization ancJ function of the 

********** 

0 * El * 

********** 

1 * FI * 

********** 

2 * Cl * 

********** 

3 * D 1 * 

********** 

a * El * 

********** 

5 * 33 * 

********** 

6 * 3 3 * 

********** 

7 * FB * 

********** 

8 * 00 * 

********** 

9 * 0 0 * 

********** 

10 * 00 * 

********** 

1 1 * C 3 * 

********** 

12 * * 

AH* 

1 3 * * 

********** 



snapshot execution table: 

POP H 
POP PSw 
POP B 
POP D 
POP H 
I NX SP 
I NX SP 
El 

rep 1 ac ed 
snapshot 
instruction 

JMP 

address of instruction 
after snapshot instruct 



At the end of the snapshot 'interrupt' process, program control 

is transferred to the first byte of the execution table 

where 



- the stack is updated 

- interrupts are enabled 

I 

- the replaced instruction is executed 

- program control is transferred back to the 1 i nterrupted' 
program. 

SNAPINT is the procedure which services the snapshot inter- 
rupt. The return from this procedure takes place as aescribed 
above . 

If the specified condition is not, met control is returned. 

If there is already a snapshot in progress, i.e. SNAPFL is 
'TRUE', a counter is incremented in order to count multiple 
occurrences of the same snapshot. 



i on 
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If none of the above applies* SNAPFL is set and the current 
value of the requested oaramefers are saved if the respec- 
tive flag ( SN V AR X * DUMPF L or REGF'L) is set. 

After saving of the soec i f i ed values and scheduling a 
priority call for procedure SNAPSHOT , SNEX TbL is executed. 

The procedure SNAPSHOT outputs the snapshot data to the CRT. 
This is done with 'synchronous output with acknowledge' message 
to the CS modu 1 e . 

The acknowledge mode prevents a possible overflow of the CRT 
output buffer. 

The returned acknowledge code is used to distribute the process 
seguentially through SNAPSHOT. 

Since this process is s t ra i gh t f o r wa r d * it is not described 
in detail. 

At the end of SNAPSHOT the f 1 aa SNAPFL is reset to allow 
the output of the next snapshot. 

Procedure SNAPTERM has the task of terminating the snapshot 
function. It is called when the 'terminate debug function' 
message is received or at system start when the system was 
stopped before with an activated snapshot. 

SNAPTERM restores the original instruction at the snapshot 
address . 



Message S i mu 1 a t i on /E x t r ac t i on 

D 8 MOD 6 consists of the functions message simulation and message 
extraction. These functions are handled in the procedures 
DBMS X * DBMSXINP and DBEXTRAC T . 

DBMSX is the entry procedure for DBM0D6 and is called from 
the message entry of the DB module. 

If flag DBTELLBACK is 'TRUE' the procedure OBEXTRACT is 
called* otherwise DBMSXINP is called. 

DBMSXINP Processes the CRT input message for simulation and 
extraction . 

In order to obtain all necessary inputs* the procedure initi- 
ates a dialog with the operator at the CRT. 

All input/output is performed with real-time messages to and from 
the CS module. 

In both cases* simulation and extraction* the dialog yields a 
message control block. 

Illegal inputs are rejectee and prompted again. 

The MCB is stored in DEBUGMCB* a table located in the system 
data area to allow access by the executive in order to check 
for messages to be extracted. 

After completion of the MCB input* the process splits. 
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Message simulation: 



The dialoq continues until the inout of data bytes as 
specified in the MCB is completed. After this# the con- 
structed message is sent. 

If the message could not, be sent the output of 'MSG NOT 
SENT ' i s i ssued . 

If the sending of the message was successful 'MSG SENT' is 
typed. 

The function terminates with the sending of the prompt 
character. 

If the last function has been 'message simulation' and 
the input of RETURN only is received, the sending of the 
same message is repeated. 

Message extraction: 

The extraction is initialized with the sending of an 
extraction messaqe to the executive. 

DBEXTRACT processes extraction messages from the executive. 

The CRT output is done using output with acknowledge messages. 
The process is straightforward and is not described here. 



Hardcopy 

The 'H' command is processed in the procedure DBHARDCOPY 
which is part of DBM0D8. 

If flag HARDCOPY is 'TRUE' then it is set to 'FALSE'. 

If flag HARDCOPY is 'FALSE' an 'initialize line printer' message 
is sent to the LP module and HARDCOPY is set to 'TRUE'. 

Before leaving the procedure, a new debug command is prompted. 

In case the line printer is not connected to the system, a 
'line printer not connect eo ' message will be received by DB. 

Upon receipt of this message the flag HARDCOPY is set to 'FALSE'. 

HARDCOPY controls the output media in procedure DBSYNCPRh. 
Depending on the state of hARDCOPY, the receiving mooule for 
the 'synchronous output' message is LP or CS. 
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Periodic Inspect /Oumo 



The inspect and dumo functions can also be executed as 
periodic functions/ i • e • the output is repeated with the 
highest frequency the system allows. 

The output of the functions is sent to LP or CS with acknow- 
ledge request. Upon receipt of the acknowledge messaqe the same 
requested output is repeated with the current contents of the 
specified locations. 



Real-time Messages 

In this section the process of the real-time messages is 
desc r i bed . 



Start 

This message is processed in procedure O0START. 

The following operations are Performed: 

- if a snapshot has been activated before the last 
system stop (DBFUNCTION = 4), then call SNAPTERM 
(restore snapshot instruction) 

- clear D0 variable data 

- clear snapshot data 

- set module status (existing and activated) 

- determine start address of procedures DBINPUT and 
SNAPSHOT 

- enter priority call for SNAPSHOT. 

The OB module is then ready to be used. 



Input Text from CRT 

This message is processed by the procedure DBINPUT which consti- 
tutes DBM0D2. 

The execution of DBINPUT is controlled by a case statement 
and the variable CRTINPUT. 

CRT INPUT = 0: 

Inout from CRT must be the initiation of the debug mode. 
'CPTR:' is typed on the CRT/CRTINPUT is set to 1 and a 
'CRT input request' messaae is sent to CS. 
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CRTINPUT = 1: 



The input of the number of SBC which the user wishes to 
debug is expected now. 



If the input is not legal, then '7-CPTR:' is typed and the 
incut request repeated. 



If the number is 0 or its own SBC number* the procedure 
DBREU is called to initiate the debug mode. 

In DBREQ the control variaole is set to 2 and a prompt 
for a debug command is issued. 

Otherwise the number of the debug module in the target 
SBC is computed. 

If the respective module is not activated, 'DEBUG MODULE 
NOT ACTIVATED' is tvoea. 

If the module is active, a 'start debug exter na 1' message is 
sent to the external debug module. 

The module number of the own CS module is transmitted in 
the first data byte. 



The control variable is reset to 0. 



CRTINPUT = 2: 



The input is the selection of a debug function. 

DBINPUT decodes the function identifier and calls the 
respective procedure to process the input. 

The variable DBFUNCTlOh contains an index which deter- 
mines the selected debug function. 

CRTINPUT is set to 3. 

CRTINPUT = 3: 



This input is caused by the selected debug function it- 
self. 

Program control is routed to the process of the currently 
activated function. 



Terminate I/O 

This message informs the DB module that the connection to 
the CRT has to be terminated (input of 'Control -I' at 
the CRT ) . 

The input control variable is reset to 0 in order to 
accept a new initialization of the debug mode. 

Any pending debug function and the debug mode are ter- 
minated. 
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I Start Debug 



This message informs DB that a 'Control-D' input has been 
made at the CRT. 

This input is processed in procedure DBINPUT with control 
variable CRTINPU! = 0 (see Section 3.7.2). 



External Start Debug 

This message is sent by a oebua module in an other SBC and in- 
forms DB that there is an external debug request from an 
other SBC . 

The message is processed in procedure DBEXTREQ. 

After saving the module number of the connected CRT in the 
other SBC in DBCRT procedure* DBREU is called to further 
process the debug reguest. 



Terminate Debug Function 

This message is received after a 'Control-!' input at the CRT 
and it serves the purpose of terminating the currently acti- 
vated debug function. 

The process takes place in procedure DBTERMPER. 

If no debug function is activated (i.e. the prompt character 
is displayed)* an error message is sent to CS. 

If the activated function is 'messaoe extraction'* a message is 
sent to EX to stop the extraction. 

An activated snapshot is terminated with a call of SNAPTERM. 

After resetting of all relevant flags* the prompt character is 
displayed. 



Output Acknowledge 

This message is received when an output with acknowledge initiated 
by DB is completed. 

The returned acknowledge code is saved in DBTBCODE and the flag 
DBTELLBACK is set to 'TRUE'. 

Then DBINPUT is called which passes program control to the 
activated function controlled by CRTINPUT and DBFUNCTION. 
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Extraction Messaoe 



This message transmits an extracted message from EX to the 
'message extraction' function in DB. 

If an extraction outDut is currently active (DBEXTRACT = 
'TRUE') a counter is incremented and OBEX TRACT is not called. 
Otherwise DBEXTRACT is called in order to initiate the typing 
of the extracted message. 



Line Printer not Connected 

The process of this message consists of resetting the flag 
HARDCOPY to 'FALSE', i.e. output is not directed to the 
line printer because it is not in operation. 
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Output Real-time Messages 

In this section the format of the real-time messaqes sent by PB 
is desc r i bed . 



Synchronous Output 





RMN 


CS or LP 








SMN 


DB 








MN 


1 1 








ML 


depends on 


1 enqt h of output 


text 




D A T A 0 


0 - no roll 


screen/cr/ 1 f after output 






1 - roll screen/cr) 1 f after 


output 




DATA 1 - 










DATAn : 


: text to be 


tyoed/p rinted 




This message is used to 


type text on the 


input line 


or 


On the 1 


ine printer. 






CRT 


Input Request 








RMN 


CS 








SMN 


DB 








MN 


12 








ML 


05 








DAT AO 


0 - no roll 


screen after input 






1 - roll screen after input 





This message requests a keyboard input from the CRT. 



Terminate CRT Input 



RMN 


: CS 


SMN 


: DB 


MN 


: 14 


ML 


: 04 



This message disconnects DB from the CRT. 



Activate Debuq 

RMN : CS 

SMN : DB 

MN : 1 5 

ML : 04 

This message is used to establish a connection between DB and 
the CRT at which the debug request was made. 
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New Line 



RMN : 


C S or 


LP 


SMN : 


DB 




MN : 


16 




ML 


oa 




message 


rolls 


the CRT screen once and places the cursor 



the beginning of the incut line or positions the print head 
the line printer at the beginning of the next line. 



a t 
o f 



Begin of Line 



RMN 


: CS or LP 


SMN 


: DB 


MN 


: 1 7 


ML 


: oa 



This message positions the CRT cursor at the beginning of the input 
line or the print head of the line printer at the beginning of 
the next line. 



Synchronous Output with Output Acknowledge 



RMN : 
SMN : 
MN : 

ML : 

0 A T A 0 : 
DATA1 : 

DATA2- 
D A T A n : 



CS or LP 
DB 
18 

depends on length of output text 
acknowledae code 

0 - no roll screen/cr/lf after output 

1 - roll screen/cr/lf after output 

text to be typed/printed 



This message is used to type text on the input line of the CRT 
or to print on the line printer and reguests an acknowledge 
message when the output is completed. 



External Start Debug 

RMN : any external aebug module 

SMN : DB 

MN : 2a 

ML : 05 

DATAO : module number of connected CRT module 

This message informs an external debug module about a debug 
request from the CRT module determined by DATAO. 
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Start Messaae Extraction 



RMN : 


EX 


SMN : 

mn : 

ml : 


DB 

10 

04 


This message 
started. The 
current 1 y in 


informs the executive that a message extraction is 
message to be extracted is described by the MCB 
DEBUGMC B . 


Stop Message 


Extraction 


RMN 

SMN 

MN 

ML : 


EX 
DB 
1 1 
04 



This message causes the termination of message extraction by 
the execut i ve . 

Initialize Line Printer 



RMN : 


LP 


SMN : 

mn : 

ml : 


DB 

13 

04 



This message is sent when the output of DB is to be switched 
to the line printer. 
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APPENDIX E 



PROGRAM DESCRIPTION OF CRT MODULE 
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General 



Int roduc t i on 

The CRT module (mooule identification: CS) is the driver for 
the CRT under the real-time operating system. 

All I/O is interrupt driven in order to meet the real-time 
requ i rements. 

The CS module ’connects* all other modules in the system to 
the CRT, i.e. the interface with the ooerator is controlled by 
the communicating module. The CS module merely oasses data in 
and out for other modul es .Except for some line editing funct- 
ions CS does not have its own interface. 

The interface between CS and a user module takes place with 
the use of real-time messages. 

The module may be shared by several SBC*s. In this case only the 
message entry procedure ana the CS data have to be local to the 
SBC * s . 

Depending on the number of the host SBC the module numbers of 
the CS module vary, 

CS is designed to communicate with a DATAMEDIA Elite 2500 CRT 
and keyboard. 



Abbreviations and Conventions 

All numbers in this segment of text are decimal except as 
indicated otherwise. 

SBC - single board computer 

MCB - message control block 
RMN - receiving module number 
SMN - sending module number 
MN - messaqe number 
ML - message length 

CS - CHI module* module number in SBC 1/2/3 : 06/10/22 
EX - executive* module number in SBC 1/2/3 i 00/08/16 

DB - debug module* module number in SBC 1/2/3 : 07/15/<?3 

INACTMOD - module number of module currently connected to CRT 
(INput ACfive MODule) 

input line - last line on CRT 

line for asynchronous outputs - line 7 on CRT 

line for synchronous outputs - last line on CRT (-input line) 
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Facilities of the CS Module 



Input 

[he CS module allows any module in the system to obtain data 
from an operator at the keyboard. 

In order to ease keyboard input, CS provides two line editing 
functions: 

- delete last input character 
• delete entire input. 

CRT input for a module is initiated with an ’activate CRT 
input' msq to CS. [his msg is acknowledged with a msg sent back. 
The first data byte of this msg determines whether the reguest 
is acknowledged or not. 

The case that CRT control is not granted can only occur if 
several modules attempt to obtain inputs at the same time. 

Cnee the connection to the CRT is established, the user module 
has to send an ’input request' msg to CS. CS then sends the next 
input terminated with the RETURN key to the requesting module. 

All keyboard inputs are displayed on the input line. 

Upon completion of the inputs, the connected module has to re- 
lease the CRT with a special msg. 



Output 

There are 2 distinct types of CRT output: 

- asynchronous and 

- synch ronous . 

Asynchronous outputs are typed on line 7 of the CRT. 

The text tyoed here is sent to CS using the 'asynchronous out- 
put' msg. This msq may be sent by any module at any time and 
serves the purpose to report errors, special internal conditions 
etc. 

The output of this message is accompanied by the bell. 

For the time of the output all input is blocked and a ' t ' is 
displayed at the position of the next input. After typing the 
asynchronous message the ' T ’ is erased with the next input. 

Synchronous outputs are typed on the incut line and allow the 
module Currently in control of the CRT to interact with the 
ope ra t or. 

'Synchronous output' messages are accepted from the connected 
modu 1 e only. 
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There 

cause 



are two messages which control the screen itself 
the cursor to be positioned at 

the beginning of a new line (roll screen once) 
the beginning of the current line. 



They 
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Input s 



The CS module receives inputs from the keyboard of the CRT and 
from other modules with real-time messages. 



I npu t from CRT 

Keyboard inputs are transmitted in form of ASCII characters. 

See DATAMEDIA Elite 2500 manual for details. 

Apart from the normal character set there are inputs which have 
special meanings. They are listed below: 



’ Con t r o 1 - 1 ' 



’ Cont ro 1 -D ' 



CRT interruption 

This input forces the termination of any 
existing connection between a module and 
the CRT . 

enter debug mode 



' Con t r o 1 - T ' 

'Back Space' 

•Rub Out ' 

•CR ’ 

The interpretation of 



terminate debug function 

delete last character 

delete entire input 

termination of current input 

these inputs is described in Section 3.2. 



Input Real-time Messages 

In this section the format of the incoming real-time messages is 
given. The process of these messages is described in Section 3.4. 



Start 

RMN : CS 

SMN : EX 

MN : 00 

ML : 04 

This msg is sent by the executive when the system is started. 

Upon receipt the CS module initializes itself 
(see Section 3.4.1). 
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Asynchronous Outout 

RMN : CS 

SMN : any module 

MN : 1 0 

ML : depends on length of text 

DAT A0- 

DATAn : text to be typed 

This message is received when a module is initiating an 
asynchronous output (see Section 3.4.2). 



Synchronous Output 



RMN : 
SMN : 
MN : 

ML : 

DATAO : 

DA T A 1 - 
DATAn : 



CS 

module currently connected to CRT (INACTMtiD) 

1 1 

depends on length of text 

0 - no roll screen after output 

1 - roll screen after output 

text to be typed 



The module currently connected to the CRT transmits text to be 
typed on the input line with this message (see Section 3.4.3). 



CRT Input Request 



RMN 

SMN 

MN 

ML 

DATAO 



CS 

INACTMOD 

12 

OS 

0 - no roll after next input 

1 - roll screen once after next 



input 



This message is sent by the module currently connected to the 
CRT to request an input from the keyboard (see Section 3.4.4). 



Activate CRT Input 

RMN : CS 

SMN : module requesting connection to the CRT 

MN : 13 

ML : 04 

With this message each module can establish a connection to 
the CRT (see Section 3.4.5). 
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Terminate CRT Input 



RMN : 


CS 






SMN : 


INACTMOD 






MN : 


14 






ML : 


04 






message 


is used by 


the 


module currently connected to the 


to re 1 ease the CRT 


(see 


Section 3.4.6). 



Activate Debug 



RMN 

SMN 

MN 

ML 



CS 

any debug module 

15 

oa 



With this messaqe the user selected debug module connects 
itself to the CRT (see Sec t i on . 4 . 7 ) . 



New Line 



RMN 


: CS 


SMN 


INACTMOD 


MN 


: 16 


ML 


: 04 



This message causes the roll of the screen by 1 line and the 
positioning of the cursor 3 t the beginning of a new line 
(see Section 3.4.8). 



Beg in of Line 



RMN 


: CS 


SMN 


: INACTMOD 


MN 


: 1 7 


ML 


: 04 



This message positions the cursor at the beginning of the current 
input line (see Section 3.4.9). 
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Synchronous Outout with Acknowledge 



RMN : 
SMN : 
MN : 

ML : 

OAT AO : 
0 A T A 1 : 

DATA2- 
DATAn : 



CS 

INACTMOD 
1 8 

depends on length of text 
acknowledge code 

0 - no roll screen after outout 

1 - rol 1 screen once after output 

text to be typed 



This message initiates a synchronous output on the input line 
and requests an acknowledge messaqe when this output is com- 
pleted (see Section 3.4.10). 
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Process i ng 



In this section the process of CRT input/output and real-time 
message is (described. 

USART Inter face 

The operation of the USART is controlled by a mode control 
word and a command control word. 

After a hardware reset » the first output has to be a mode 
control word. After havinq received the mode control word 
the USART accepts any number of command control words. 

If it is required to output a mode control word without a 
hardware reset/ the USARI can be reset with a special con- 
trol word. 



Ihe formats of the control words and the input/output ports 
are given below. 

Mode Control Word: 



bi t 


7, 6 


• 


0 1 


- 1 STOP BIT 


ff 


5/ a 


• 

• 


00 


- NO PARITY 


If 


3, 2 


» 

• 


10 


- 7 BIT CHARACTER LENGTH 


II 


1/ o 


• 

• 


10 


- BAUD RATE FACTOR 16 


Command Control word: 




b i t 


7 : 


0 






m 


6 : 


0 


- 


NO RESET 










RESET IJSART 


H 


5 : 


l 


- 


REQUEST TO SEND 


•i 


a : 


0 






M 


3 : 


0 






if 


2 : 


1 


- 


RECEIVE ENABLE 


H 


1 : 


1 


- 


DATA TERMINAL READY 


M 


0 : 


1 


- 


TRANSMIT ENABLE 


I npu t/Outout 


port 




for 


status information is 0EFH, 



0EE.H . 



10 



i40 



Input f rom CR T 



All CRT input is interrupt driven. 

Upon system start* the USART (CRT input) is initialized and the 
respective interrupt is activated. 

If a key on the keyboard is hit* an interrupt occurs. The inter- 
rupt procedure decodes the interrupt and schedules a call of the 
the priority Procedure CSII\PUT. 

After the call of CSINPUT by the executive* an input instruction 
is executed to obtain the input character. 

Without any filtering the following inputs are considered in the 
the indicated sequence and processed: 



- 1 Con t ro 1 - I * 


• 


CRT interruption 




• * Con t r o 1 -D 1 


• 

• 


initial i ze debug 


mode 


• 'ControW 


• 

• 


terminate debug 


f unc t ion 


* Con t r o 1 - 1 * : 








This input forces the termination 
between a module and the CRT. 

If a module is currently connected 


of the current 
to the CRT 



(INACTMOD <> FFH)* then a 'terminate I/O' msg is sent to this 
modu 1 e . 

If no module is connected* no actions take place. 

'Control -O' : 

This incut initiates the debug mode. 

If debugging from this CRT is already activated* the error 
indication '?' is written into the output buffer. 

If the request is legal* any current connection between a 
module and the CRT is terminated with the 'terminate I/O' 
message and a 'start debug' message is sent to the debug 
module in the same SBC. 

' Cont ro 1 - T * : 

This incut causes the sending of a 'terminate debug func- 
tion msg to the connected debug module. If not in debug 
mode* a '?' is written into the output buffer. 

All other keyboard incuts are considered only if 

- no output is active 



an 



'input request' msg has been received 



Back Space': 



This input causes the celetion of the last input character 
on the screen and in the input buffer. 

The cursor is moved back and the last input is erased. 

An attempt to move the cursor past the beqinninq of the last 
input request is not accented and answered with the bell. 

'Rub Out ’ : 

With this key the entire input of the last input request can 
be erased. The cursor is moved back to the first position of 
the last input request and the rest of the line is deleted 
so that a correct input line can be qenerated. 

•RETURN ' : 

This key terminates the current input. 

The input collected startinq at the position of the cursor 
at the last input request is sent to the connected module 
with a 'transfer input text' messaqe. 

Depend inq on the specification in the last 'input request' 
message* the screen is rolled once or not. 

All other inputs: 

The input ASCII character is checked for legality. Legal 
codes have to be within the range of 1FH < input code < 5 A H 
and within the length of the input line. 

If the input is illegal a '?' is written into the output 
buffer* otherwise the input is stored* the input buffer 
pointers are updated and the input character is written 
into the output buffer. 

Before returning program control to the executive* the output 
of the current output buffer contents is initiated. 
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0 u t o u t to CRT 



All CRT output is interrupt driven. 

At system start the following codes are written into the 
output buffer: 

- clear sc reen 

- set roll mode 

- output '*** SYSTEM START' and bell on the line for 
asynchronous outputs 

- position cursor at the beginning of input line. 

Then the output is activated by executing an output instruction 
for the first character in the output buffer. 

Upon completion of the output# an interrupt occurs which is 
processed by the interrupt routine. After determining the source 
of the interrupt# a priority call of CSOUTPUT is scheduled. 

If there are no more characters for output# the output buffer 
pointers are reset to 0 ana an acknowledge message is sent to 
INACTMOD if requested. 

Otherwise the next character from the output buffer is trans- 
ferred to the USART and the buffer pointers are updated. 

The output buffer CRTOUT has 2 pointers: 

- OUTPTR (next character for output) 

- OUTX (next character to fill). 

CRTOUT is emoty if OUTPTR >= OUTX. In this case both oointers 
are reset to 0. 
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Real-time Messages 



Start 

This message informs CS that the system has been started. 

CS Performs the following initialization steps: 

- reset USART if no system reset has been performed 

- clear all local variable data 

- determine begin addresses of priority procedures CSINPUT 
and CSOUTPUT and store in CSINADR and CSOUTADR 

respect i vel y 

- set module status: 

. modu 1 e exists 
. modu le activated 

* module author) zee to suspend/activate other modules 

- reset pointers and flags 

- enter priority calls of CSINPUI and CSOUTPUT 

- initialize USART 

- pack 'start output' into output buffer 

- initialize output to USART 



Asynchronous Output 

With this messages text to be typed on the line for asynchronous 
outputs (line 7 on CRT) is sent to CS. 



For the duration of the output? an uparrow ('T') is displayed 
at the current position of the cursor on the input line. 

After completion of the asynchronous output? the cursor is 
returned to its last position on the input line. The next 
keyboard input erases the ' t ’ . 



[he following output is initiated: 

- • T ' 

- move cursor to the beginning of line 7 

- clear line 

- pack bell 

- pack * * * * * 

- pack output text (from message) 

- pack code to return cursor to the last input position. 

After packing the output buffer# the output is initiated with 
the cal 1 of STARTOUT. 



Synchronous Output 

This message causes the typinq of the transferred text on the 
i npu t line. 

If SMN of this message is cifferent from INACTMOD# then the 
system routine ILLEGALMSG is called and the message rejected. 

If the messaqe is legal# the text of the message starting at 
data byte 1 is moved into the output buffer. 

If data byte 0 is TRUE# then the roll of the screen after the 
output is requested and the respective characters are entered 
into the output buffer. 

If no roll is requested# the position of the cursor on the input 
line is incremented Oy the number of characters in the t rans- 
f erred text • 

The output to the CRT is initiated with a call of procedure 
STARTOUF . 



CRT Input Request 

This message requests an input from the CRT keyboard. 

If SMN is not INACTMOD# then the system routine ILLEGALMSG is 
called and the request is rejected. 

The cursor position and the input buffer pointer are saved in 
order to mark the beginning of this input for line editing. 

The variable ROLLSCREEN is set according to data byte 0 of the 
msg • 
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Activate CRT Inout 



This message is sent by a module which wishes to establish a 
connection to the CRT. 

This reguest is answered with an acknowledge message in which 
the first data byte indicates whether the reguest is acknowledged 
or not. 

$MN of this message is saved in the variable INACTMOD. 



Terminate CRT Input 

This message terminates the connection between the sending 
module (SMN = INACTMOD) ana the CRT. 

CS resets INACTMOD to FFH . 



Activate Debug 

This message connects a debug module to the CRT. No acknowledge 
message is sent in this case since this reguest is always 
grant ed . 

INACTMOD is set to the module number of the debug module. 



New Line 

This message is internally converted to a 'synchronous output' 
message and the procedure for synchronous outout is called. 



Beginning of Line 
See Section 3.4.8 



Synchronous Output with Acknowledge 

The process of this message is essentially identical to the 
process of a synchronous message without acknowledge 
(see Section 3.4.3) with the exception that the sending module 
reguests a message to indicate the completion of the initiated 
output . 

This feature can be used to avoid overwriting of text and 
buffer overflows. 

The first data byte contains the acknowledge code which has to 
be returned with an acknowledge message after completion of 
the output. 
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Outouts 



The CS module outputs data to the CRT and sends real-time 
messages to other modules in the system. 

Output to CRT 

Outputs to the CRT are transmitted in form of ASCII characters. 
See DATA MEDIA Elite 2500 manual for details. 

The only ASCII exception is the use of the XY addressing 
feature of the DATAMEDIA, 

This mode allows the arbitrary positioning of the cursor. 

The XY mode is initiated with ' 0 C H ' . The following two characters 
(coded according to the manual) are considered to be a location 
on the CRT. The first determines the position in a row and the 
second character determines the row. 

If CS detects an illegal input character, then this is indicated 
with the output of '?'. 



Real-time Messages 

In this section the format of the real-time msg sent by CS is 
desc r i bed . 

Transfer Input Text 

RMN : INACTMOO 

SMN : CS 

MN : 20 

ML : depends on length of input text 

DATA0- 

DATAn 5 input text 

This message is used to send input text to the reguesting 
modu 1 e . 

Activate CRT Input Acknowledge 

RMN : INACTMOD 

SMN : CS 

MN : 21 

ML : 05 

DATAO : TRUE - reguest acknowledged 

FALSE - otherwise 

This message informs the module which wants to activate CRT 
input whether the reguest is granted or not. 
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Terminate I/O 



RMN : 


INACTMOD 


SMN : 


CS 


MN : 


22 


ML : 


00 


[his message 


is sent 


the CRT when 


the CRT 



Start Debug 




RMN : 


DB 


SMN : 


CS 


MN : 


23 


ML : 


00 



to the module currently in control 
interruption input (Control -I) is 



o f 

detected. 



This msg informs the debug module that the leqal input 
'Control-D' has been generated. 



Terminate Debug Function 

RMN : DB 
SMN : CS 
MN : 25 
ML : oa 



This message informs the debug module that the input of 
'Control*!' has been detected. 



Ac know 1 edge 



RMN 

SMN 

MN 

ML 

DAT AO 



INACTMOD 

CS 

26 

05 

acknowledge code 



This message indicates the completion of an output with 
acknowledge request. 

The acknowledge code is identical to the code received with the 
'synchronous output with acknowledge' message. 
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Gene r a 1 



Int roduc t i on 

The line printer module (LP) is the driver for the CENTRONIX 101 
line printer under the real-time operatina system. 

All output is interrupt driven in order to meet the real-time 
requ i rements. 

The code of the LP module rray be shared by several single 
board comouters if more than 1 line printer is to be connected 
to the system. 

All modules in the system can initiate printouts on the line 
printer by transferring text to LP with a real-time message. 



Abbreviations and Conventions 

All numbers in this segment of text are decimal except when 
indicated otherwise. 

SBC - single board computer 

MCB - message control block 
RMN - receiving module number 
SMN - sending module number 
MN - message number 
ML - message length 

CS • CRT module# module number in SBC 1/2/3 : 06/14/22 

EX - executive# module number in SBC 1/2/3 : 00/08/16 

DB - debug module# module number in SBC 1/2/3 l 07/15/23 

LP • line printer module# module number in SBC 1/2/3 : 05/13/21 
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Facilities of the LP Module 



In order to allow the switching of outout between CRT and 
line printer, the usage of the line printer is very similar 
to the C R I output, i.e. is controlled by the same messages. 
(Exception: the 'beginning of line’ message is interpreted as 

'new line' message.) 

LP allows to print any text sent to the module with the 
'print' message. The text is transferred in the data bytes of 
the message and has to be ASCII coded. 

This text can be printed with or without the generation of 
a acknowledge msq to indicate the completion of the printout. 

Apart from the 'print' and 'print with acknowledge’ message 
there are 3 form control message: 

- new page 

- new line 

- beginning of line (interpreted as new line). 

LP accepts an 'initialize line Printer' messaqe. Upon receipt 
of this message the proper connection of the line printer is 
checked. 

If the check is positive, the print head is positioned at the 
beginning of a new pane. 

Otherwise a warning messaqe is typed on the CRT and a 'line 
printer not connected' message is sent to the module which re- 
quested the check. 



I nput s 

The LP module receives inputs from 

- line printer (status inputs) 

- other modules (real-time messages). 

Status Inputs from Line Printer 

Two status bits from the line printer are made available 
for LP on input port E6: 

-bit a : 'SELECT' 

- bit 3 : 'LPT BUSY ’ . 
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Input Real-time Messages 

In this section the format of the incoming real-time message is 
given. 

The process of these messages is described in Section 3. a. 

Start 



RMN 


: LP 


SMN 


: EX 


MN 


: 00 


ML 


: 04 



This message is sent by the executive when the system has been 
started. 

Upon receipt the LP module initializes itself 
( see Section 3.4.1). 



Print 



RMN 


LP 








SMN 


any module 








MN 


1 1 








ML 


depends on 


length of text to 


be 


p r i n t e d 


DA T AO 


0 - no new 


line after output 








1 - new line after output 






DATA1- 










DATAn : 


: ASCII characters to be printed 




The text transferred with this message is 
line orinter (see Section 3.4,2). 


t 0 


be printed on the 



New Page 












RMN : 


LP 










SMN : 


any 


modul 


e 






MN 


12 










ML 


04 










This me s sage 


request s 


the positioning of 


the print 


head at 


the beginning 


O f 


the first line on a new 


page (see 


Section 3.4.3). 



Initialize L 


ine Printer 


RMN : 


LP 


SMN : 


any module 


mn : 


13 


ml : 


04 


This mess age 


causes LP to check the status of the line printer 


(see Section 


3.4.4). 
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New Line 



RMN 


: LP 


SMN 


: any module 


MN 


: 16 


ML 


: 04 



This message Positions the print head at the beginning of a 
new line (see Section 3.4.8). 



Beginning of 


Line 


RMN : 


LP 


SMN : 


any modu 1 e 


MN : 


17 


ML : 


04 


This message 


i s processed 


(see Sec t i on 


2.2.5) . 



as being a 'new line' msg 



Print with Acknowledge 



RMN 

SMN : 
MN : 

ML : 

DATAO : 
DATA1 : 

DATA2- 
DA T An : 



LP 

any modu 1 e 
18 

depends on length of text 
acknowledge code 

0 - no new line after print 

1 - new line after print 

ASCII characters to be printed 



The transferred text of this message is to be printed ana upon 
completion of the printing an acknowledge message with DATAO 
has to be returned to the sending module (see Section 3.4.6). 
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Process i nq 



Line Printer Interface 



Line Printer Status Input 

Upon receipt of the 'initialize line printer' messaqe, LP reads 
the 'SELECT' status bit of the line printer. 

If the line printer is connected ('SELECT' bit = 'FALSE') 
the procedure LPNEwPAGE is called. 

If the line printer is not connected properly: 

- an 'asynchronous output' msq is sent to CS to type a 
warning '*** LINE PRINTER NOT CONNECTED' 

- a 'line printer not connected' msq is sent to the module 
which sent the 'initialize line printer' msg. 



Line Printer Output 

All line Printer output is interrupt driven. 

The output characters are written into the outout buffer 
LP0UT6UF. LPOUTBUF is controlled by two oointers: 

- LPOUTX (next to fill) 

- LPOUTPTR (next to print). 

LPOUTBUF is empty if LPOUTPTR >= LPOUTX. In this case both 
pointers are reset to 0. 

An overflow occurs if LPOUTX > last index of LPOUTBUF. This 
condition causes a call of the system monitor ana output 
characters are rejected until there is space in LPOUTBUF. 

When all text is transferred from the 'print' message into the 
output buffer/ or an overflow occurs/ the output is started by 
calling the output procedure. 

When the output of a character is completed/ an interrupt is 
generated and the priority call of the procedure LPOUTPUT is 
scheduled by the interrupt procedure. 

After LPOUTPUT called by the executive/ the next character is 
is Put on the output line or the printout is terminated 
(if LPOUTBUF is empty). 

In the latter case the flag LPTELLBACK is checked and an ack- 
nowledge message is generated if necessary. 
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Real-time Messaqes 



Start 

This message informs LP that the system has been started. 

LP performs the following operations: 

- clear all local variables 

- determine start address of Procedure LPOUTPUT 

- enter priority call for LPOUTPUT 

(to be called if a line printer output interrupt occurs) 

- set module status 

. module exists 
. module activated. 



Print 

This message is processed in procedure LPPRINT. 

The data bytes of the msg are moved into the output buffer until 
all characters are moved or an overflow occurs. 

In case of an overflow, the move of characters is terminated 
and the output is initiated. 

When the remaining space is sufficient and all characters are 
moved, then DATAO of the msq controls the insertion of code for 
a 'carriage return' and a 'line feed'. Then the output is initi- 
ated. 



New Page 

The code for 'form feed' is packed into the output buffer and 
the output is activated. 



Initialize Line Printer 

LP reads the 'SELECT' status bit and determines whether out- 
put is possible or not. 

If no printing is possible, i.e. the printer is not connected 
properly, the typing of a warning message at the CRT is generated 
with an 'asynchronous output' msg to CS. 

Otherwise, the 'new page' procedure is executed 
(see Section 3.4.3). 



New Line 

The code for 'carriage return' and 'line feed' is packed into 
the output buffer and the output is activated. 
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Print with Acknowledge 



This message is processed by the procedure LPPRINT (see 
after the acknowledge code has been removed from the msg 
The code and the sending module is saved. 

After completion of the output an acknowledae message is 
back together with the reouested acknowledge code. 



.« . 2 ) 
sent 
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Outputs 



The LP module outputs data to the line orinter and sends 
messages to other modules in the system. 

Output to the Line Printer 

Outputs to the line printer are transmitted in form of ASCII 
charac ters . 

Letters are printed as capital letters only. 

See the available CENTRONIX 101 interface specification. 
Output Port is port E4H. 



Real-time Messages 



Asynchronous Output 



RMN : 


CS 


SMN 


LP 


MN 


1 0 


ML : 


30 


DATA0- 




DATA25: 


text 



'LINE PRINTER 



NOT CONNECTED' 



Ac know 1 edge 



RMN 

SMN 

MN 

ML 

DAT AO 



module which sent 'print with acknowledge' message 
LP 
26 
05 



acknowledge code transferred with 'print with 
acknowledge' message 



Line Printer not Connected 



RMN 


: module which sent 1 


'initialize line printer' message 


SMN 


: LP 




MN 


: 28 




ML 


: 04 





This message informs the reguesting module that the line printer 
is not connected properly to the system. 
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/+ INITIftLIZE PERIODIC: LIST */ 
PERL I ST < B1 > . FREE = TRUE.; 

END.; 
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/* SET NEW TIME INTERVAL 

102 2 CALL SETPERT I ME < PI > ; 

/* SET NEW CALL TIME */ 

103 2 RETURN; 

104 2 END PERCHG; 
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IF PI >= MflXPR I OR THEN RETURN.: 
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ENTER NEW PRIORITY CFlLL IN PRIORITY LIST 

INPUT : ADDRESS OF PRIORITY PROCEDURE 
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REMOVE PRIORITY CRLL FROM PRIORLIST 
INPUT: PRIORITY INDEX 



REMPRIOR: PROCEDURE <P1> PUBLIC; 
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102 1 ENTER I NT: PROCEDURE <P1, P2> BYTE PUBLIC; 
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if 




Z LL 


UJ 


CC 




if 








Ci 




if H 








LL 




if CC 








-J 




if H 












if LO 












if Ct 


-I 








if 


if X LL 


O 








if 


if if D 


Ci 







ii 
* * 



* 

I 

if 

if 

if 

★ 

if 

if 

if 

* 

* 

if 

* 



if if 
if if 



* 
★ 
if 
if 

if if 
X if 



rH 


C.J 


C.J 


oJ C.J 


© 


rH 


C.J 




ri 


rO 


M 


,V, |Vj 
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* * * :* * :+ : : sfc # :* :+ : :+: :**• '•+: :f: :f= :+ : :* : : :* :+ : 

* :+c :fc :fc :+: :f- :+: :+: :+: :+: :+: :f; :-f: :fc :f: 



RETURN ADDRESS OF BEGIN OF CALLING PROCEDURE 



OJ 



UJ 

a 

x 

X 



* 

* 

★ 

I 

I 

* 

if 

if 

* 

1 

* 

if 

if 

if 

if 

if 

if 

1 

if 

* 

if 

* 

* 

if 

if 

1 

* 



I 

* 

if 

if 

if 

I 



o 

tn 

•X 



u 

o 



* 

if 

if 

* 

if 

* 

* 

if 



x 

Hi 











if 


if 




if 












if 


if 




if 












★ 


4. 




if 












if 


if 


to 














* 


if 


X 


if 






A 






if 


if 


o 








OJ 






if 


+ 


L J 


if 






X 






if 


if 


o 


if 






. 






if 


if 




if 












HK 


if 


H-l 


if 












if 




HH 


if 






H 








4 


a 


if 






X 






4 


if 


X 


if 












■£ 


+ 


X 


if 






UJ 






if 


if 




if 






H 






if 


if 


oj 


if 




a 


> UJ 






if 


if 




if 






X H 








if 


o 


if 




-j 


J H 




... 


if 


if 


i- 


if 


• ^ 


ca 


/■\ Qj 




Q 


4 


if 


2 X 


if 


O 


— « 


-J 






if 


if 


HH 


* 


HH 


Cl 


OJ 


•«. 


to 


i 


if 


z 


if 


-J 




X OJ 


t! 


D 


if 


if 


X *-* 


if 




01 


-w 


tH 


"5» 


if 


if 


X X 


if 


3 


U"i 


“ i 




h— » 


if 


if 


X H Oi 


if 


X 


Ui 


OJ .-N 


1 


X 


if 


if 


Z > X 


if 




CL 


X H 






if 


if 


D X Ci 


if 




Cl 


v iX 


.^s 




if 


if 


Z O 


+ 




o 


-» 


© 


rH 


if 


if 


U 


if 


X 


X 


to C 






if 


if 


X X 


if 






UI UJ 


... X 


X 


if 


if 


X X HH 


if 




UJ 


UJ to 


x a 


Q 


if 


if 


IlQh 


if 


X 


CL 


X X 


H 1— 


H- 


if 


4 


z o 


if 


X 


D 


l2i X 


X IL 


iL X 


if 


if 


H © tO 


if 


D 


O 


Ci 


^ O 


o .. Ci 


if 


4 


HH Z X 


if 


C 


UJ 


X X 


O X 


X OJ X 


if 


if 


a 


if 


X 


o 


o 


X H 


H- X CJ 


if 


if 


HH • • • • 


if 


Q 


o 


h* 


H tO 


to Q 


if 


if 


C 


if 


a 


CL 


oj iL 


U*i 


Z X 


if 


if 


H 


4 


X 


Cl 


X o 


i! 


ii X X 


if 


if 


OJ H D 


if 


X 




X 


ii 


3 


if 


if 


-J X 


if 






H H 


D 


J H u 


if 


if 


H X H 


if 






x to 


H OJ OJ UJ Z 


if 


if 


X Z Z) 


if 






V 


X X 


X X UJ 


if 


if 


X >-» u 


if 




. . 








if 


if 


> 


if 




CL 








if 


* 


z 


if 


a 


Cl 

•X 








II 


a 

o 


if 

if 


U*i 

X 


o 








if 


if 




if 


> 


o 


-J 






if 


if 




if 


z 


CL 


O 




* 


if 


if if 


* 


if 


X o 


Cl 


Ci 




X 


if 


if if 


* 


if 


if o 



x 

o 

l v l 



LU 

H 

“V 

x 



x 



u 

0 

© 

>:o 

1 





C.j 


C-.J C*J OJ OJ OJ 


H 


OJ 


0-J 


hi 


•J 


N CO •?. © H 


OJ 


M 


*T 


i v l 


i v l 


|V, ,V, |V| Tf Tf 









IL 
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<P1 AND GGGG1111EO 



PL/M- 80 COMPILER PAGE 



n 







jf 


if 


*/ 






jf 










jf 


•4- 






if 


if 


© 






•4- 










jf 


jf 






Hh 


jf 


© 






jf 










jf 


jf 






* 


•jf 


© 






if 




•*v 






■4- 


if 






jf 


if 


Ci 






if 




10 






if 


■4- 






if 


if 


















if 


-f- 






jf 


if 








jf 




l 






if 


if 






if 


■if 








if 










* 


k 






jf 


■* 








if 










* 


if 






jf 


if 








•4* 




© 






if 


jf 








jf 








-jf 




X 






jf 


if 






jf 


jf 








if 




V 






if 


if 






jf 


if 








jf 




© 






•4* 


jf 






■4- 


* 




X 




jf 




Uj 






if 


jf 






* 


if 




H 




if 




X 






4- 


jf 






* 


jf 




X 




if 










jf 


if 


X 




•4* 


jf 




Ci 




•4- 




li 






•if 


•^ 


© 




jf 


if 




© 




if 




V 






if 


if 


l v l 




jf 


•+■ 




U] 




if 










■¥- 


jf 






jf 


if 




X 




jf 




tH 






•4- 


if 


+ 




jf 


*$■ 








if 




© 






if 


jf 






jf 


jf 




21 




jf 










■f 


jf 






if 


if 




H~4 




if 




Cl 






* 


jf 


’t •-> 




if 


if 








if 




jC. 






if 


if 


N. -v N 




jf 


jf 




\S 




jf 




X 






jf 


jf 


/•% 




if 


•^ 




—w 

jCm 




jf 










•if 


•4- 


+ © + 




if 


if 




X 




■if 




\ 






if 


if 


© 




•+■ 


jf 




© 




* 










if 


•4* 


-J © D 




if 


if 




© 




if 




\ 






* 


if 


CO © © 




if 


if 








if 










if 


if 


© 






■4- 




X 




■¥■ 




il 






if 


if 


ii tH i! 




if 


if 




o 




* 










jf 


jf 


tH 






■4- 








jf 


O 


/*\ 






if 


if 


J H D 




if 


if 






."-V 


■4- 


H4 


rH 






if 


*£ 


© H © 




■£ 


jf 




H 


rH 


if 


© 


© 






if 


jf 






if 


if 




© 


© 


if 


© 








if 


if 


X Ci X 




if 


jf 




H 


v 


if 


D 


X 






jf 


if 


© X © 




jf 


if 






X 


jf 


© 


H 






jf 


if 


XXX 




jf 


•+• 




O 


H 


if 




X 


••% 




jf 


jf 


K H 




if 


if 




h- 


X 


* 


© 


Ci 


H 




-¥> 


if 


rH 


••* 


* 


jf 






Ci 


if 


© 


© 






if 


if 


X © X 


o 


if 


jf 




H 


© 


•¥• 


D 


© 


+ 




■jf 


if 


CT‘i '-■* Ch 


U1 


if 


if 




© 


© 


if 


Ci 


X 






if 


if 


| V, v./ |VJ 


X 


jf 


jf 






X 


if 


© 




rH 




jf 


if 


© 


> 


■+■ 


jf 




© 




■* 


CJ 


© 


© 


© 


jf 


if 


A O A .. 


jLm 


if 


if 




© 


{— 


jf 


o 


© 




•% © 


jf 


•4- 


© X 


o 


if 


jf 




H 


X 


if 


© 


►H 


II 


.. X © 


jf 


if 


© D © 


o 


-If 


■4- 




x 




•4- 


© 


X 




Ci © Ci 


if 


if 


© II © D 




-If 


if 




1-4 


© 


if 




©k 


rH 


X -J 


if 


if 


1 — 


Ci 


jf 


jf 




o 


“jr 


if 






© 


© H Ci 


if 


if 


Ll D Ll © 


—ir 


if 


if 




© 


»—» 


■if 




g 




© X 


■if 


jf 


b-4 © »— I © 


© 


•If 


jf 






H 


if 




Ci 




© © 


if 


jf 






jf 


if 




© 


© 


jf 










jf 


if 






■if 


■+• 




> 


X 


if 










jf 


if 






■|f 


if 




g 


K 


if 


» • 








if 


if 






if 


if 




X 


© 


if 


\x 








if 


if 






if 


if 








jf 


© 








if 


if 






if 


jf 








if 


© 








if 


if 




if 


jf 


if if 






* 


if 


X © 






Hh 


if 


if if 




X 


if 


if if 






if 


jf 


if Ci 






x 


jf 


if if 



CvJ CM CM CM C.J 




C.J M M CM CM 


\T> fv CO © rH 


CM 


M U“> © N 


n- ’t 


10 


a:« LO \n io 
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CONVERT ASCII CODES IN MSGDATA TO HEX NUMBER 
START IN AT MSGDAT A < B1 > 

CONVERTED NUMBER IS LEFT IN A4 



X 

0 

a: 



x 

LU 



LU 

01 



x 

-j 

H 

LU 

X 



4 

* 



* 

3 

3 

• 4 - 

3 

3 



a 

o 

X 

LL 



3 
£ 

3 
3 
3 
3 
■+■ 

3 

3 I— 
3 X LU 

3 3 Q 



Z> 



3 

01 

I— 



LU 

D 

X 



a x 

_* 3 
H- 

LU X 
X LU 



LU 

X 

H 



LU 



2 


★ 








X 


V 


X 










X 


X 


3 












X 










3 


X 


•4- 








H 


11 


0 












X 


3 








i 




X 










X 


1— 


* 








X 


rH 


X 






\ 




X 


o 


* 










X 








X 




H- 




3 








X 


X 


X 


*n 




\ 




O 


LU 


3 








H 




X 


X 








X X 


oi 


■+■ 








X 


X X 


01 




\ A 

* 1 » 




X N 


x 


3 




•*\ 




Ci 


0 




X 




CT*. 




X M 


X 






x 




0 




\ 


X 


X 


\ H 


X X 


X 






1 




in 


\ 


I 


X 


3 


X 


01 


O I 


% 


if. 




X 




X 










II X 


X 




# 


3 




H 






\ 




z 


X 


V 


X X rH 




i 








X 




0 


X 


0 


\ x X X X 




3 




z 




0 


II 


z 


D 


X 


■H 0 0 




0 X 


0 


3 


•*% 


X 








X 


h- 


X 


X '• 


2 


X 




3 


O 


0 




C; 


rH 




X 


X 


X 


X 


X II 


01 




HH 


h- 






X 




X 




I X 


x 


X 


HH 


3 


-J 


X 




X 


X 


• 4 




o 


0 


H 


H-I rH 




3 


X 


.. X 




•->. rH 




N 


z 


0 


Z rH 


X 


X 


X 


3 


X 


in 




M 0 X 


X 




X 


h- .. 


X X V X 


3 X 


LU 


3 


X 






X H ^ 


0 


0 


I 




X 




X ♦*% 


CD 


■¥> 




1 X 




X X 




z 


1- 


X 


s rH 




X rH 


X 


3 


LU 


X 




H- H 


\ 


X 




X . 


0 II X 


X 


01 X 


”i 


3 


H 


/N H 




uXX 






C0 


X T 


\ x 


X 


X X 




3 




X 


M H X 0 


\ 


\ 


X 


Z X 


rH 


H- 


X 




3 


X 


X M 




> 0 






X 


_» v 


11 X X 




+ 


X 


3 




v X 


+ 


rH Z 01 


II 


\ 




Z X 


A X ^ 






►-H 


3 


X 


0 X 




X 0 X 






A 


X 










* 


X 


01 


rH 


u 


rH 


3 




3 01 


rH Z X 




X 


x 


3 


x 


.. X A 


X 


II II 


X 


X 


rH 


% 


X X 01 






X 


3 


Ci 


© 




3 


X 




X 


II 


X X X 




II ... 


X 


3 


LU 


11 rH 


11 


rH X rH 










H X 




0 



li LU LU 

VA CO 

* co u. x o 

X X X Ci 



LU Ll 
X hh 



rt X 
X hh 



LU • 
X X 
X D 
H Z 
H 
Z LU 
X 0 

tZ J 

XliJhD 
LU Z 
X LU 



U 

0 

0 

CO 

1 



rH 


CO CO CO CO CO 


M M 


i-1 


M i v i 


rl 


r -1 M M CO CO tH 


X 


CFi 0 rH l v 1 rf 


10 X 


CO 


0 rH 


M 


IO X N CO 01 0 


to 


10 X X X X 


X X 


X 


N N 


N 


N N N N N X 



LL 
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END SCPUB6; 



H 






A 


























in 


























i v i 




































£ 


if X 

if O 








LU 






X 










if 








0 






H 










if 


if X 








a: 

LL 






CD 










★ 

if 


if 0*1 

if >• 














LU 










* 


if 0*1 














-1 










* 


if 




0*1 


X 








LU 










if 


if 




X 


H 








0 

X 










if 

if 


if 

if 




1 

CJ 


X 

o 








Cl 










if 


* 




u 


1— 1 


















if 


if 




u 


Q 








.^w 










if 


if 














0 










■£ 


if 




*^r 


1— 1 








CO 










if 


if 




Q 










-‘j 










if 


if 




i— i 


0 








X 










if 


if 




f- 










t— 










if 


if 




HH 










Ci 










if 


•f* 




L J 


h- o 








HH 










★ 


* 




21 


3 « 


















Hh 


if 




Q 


a h 








LU 










* 


if 




O 


H HH 








a 








... 


* 


if 






X Ci 








X 








X 




if 




X 


HH 21 








X 








X 




if 




o 


X 0 
















X 


if 


if 




X 


X u 








H 








X 


if 


if 




X 






N 




O 








X 


if 


if 




X 


. 0*1 X 






LU 








H 


^f 


■+■ 






0 3 0 




CO 




*-> 




•■s 




X 


if 


if 




X 


K l-i X 




3 




X 




X 




X 


if 


if 




X 


XXX 




CL 




Q 




X 






■if 






21 


O X 




O 




o 




X 




X 


* 


if 




X 


Ci X 




0*1 




21 




X 




H 




if 




X 


XXX 












LU 




1h 


if 


if 




h- 


Cj O 0 




UJ 




o 




h- 




X 


if 








X X 




X 




X 




X 






+> 


if 




1— 1 


X > X 




3 




0*1 




X 




.A 


if 


if 






O 0*1 o 




Ci 












H 


* 






*^r 


X X ►H 




U 




K 








X 


if 


if 




X 


X H 




El 




X 




H 






if 


if 






X X 








3 




X 




0*1 


■f 


if 






X X o 




Ll 




X 








X 0*1 


if 


if 




X 


X o 




O 




o 






•r 


X X 


Hh 


if 




X 


X 0*1 X 








0*1 




X 


X 


3 X 


* 


if 




X 


X 




21 




. . 




X 


K 


Ci o 


* 


+ 


X 




0*1 H Ci 




O 








D 


"V 


X C. ... 


if 


if 


LJ 


o 


K X X 




HH 




X 




Ci 


X 


O X Ci 


if 


if 


f- 


X 


*-* X X 




H 








X 




O X 


if 


if 


H- 1 


X 


X X 




X 








a 


■H 


X H X 


if 


if 


21 


X 


HH X X 




-1 




© 




u 


X 


X X 0*1 


if 


if 


0 


X 


XXX 




HH 


0 CO 


o 


X 


•r 




if 


if 


X 


o 


O 3 




Cl LU 


X 


a 


X 


o 


Ci 


if 


if 






X K 




X 


H 


3 






21 


X 


if 


■*■ 


V* 


X 


XXX 




u 


0*1 


X 






X 


X 


if 


if 


X 


X 


X 0 X 




O LU 












if 


if 


H 




O X 






“i 




* * i— 


o 


X 


X 


if 


if 


0*1 


"h 


0 01 X 




© 


G 


. . 


N 0*i 


0*1 


X 


X 


if 


if 


J~ 


X 


X > x 






LU 


J- 


CD »-h 


X 


X 


•• X 


if 




0*1 


X 


X 0*1 H 




i v i 


CL 


CD 


3 X 


“w. 


X 


Ci X 


if 










X 


> 






X O 




Cj 


X o 


if 


if 










UJ Cl 


O X 


o 


X 


X X 


if if 


★ * 








LU 


I _l LU 


0*1 * 


o 


o 


0*1 Ci 


X if 


if if 










CO 




\/ 




















►— 1 




UJ 


o 




















Cl 


IE 


o 


mT m 




















T 


\ m 


TT" 


*"T 




















o 


X 




HH 




















O 


CL 


H 


























o 


X 




H 


CJ C-*i H O'J CM 












© 


HH 


LU 


X 




















CO 


►H 


*-> 


X 




















X 


1 


LU 


HH 




















X 


0*1 


LJ 


X 


H 


© 


H (M 


r i i n 












\ 


HH 












M M M 












X 


O'l Q 


o 




















CL 


HH 


T r 


O 
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INPUT: PI - LOCATION OF ERROR OR OTHER ADDRESS VALUE 
P2.. P3: - BYTE VALUES TO SPECIFY ERROR 

^:-+: i+: * + * ■* + :+: 



PL/M-80 COMPILER PfiGE 



OJ 



CO til 
ii H 

c-i in 

OJ OJ 

*w* 

H- H 
X X 
lii UJ 
H* h* 

z z x 

»-! U ... •+• 










.. 




• "S 




CL H- 




















J 


-J 


-J 


1 


-J CL 




















CO 


CO 


CO 


CO 


H- O 
















0 












UJ 
















FH 


.. 


ii 


ii 


ii 


ii 


CL O 
















-J 


1 x 1 .•% 










H 
















CO 


H LJ 


A 


A 


<T\ 


A 


z 
















- J 


j- 1 — 


X 


0 . 


H 


** 


UJ 0 
















LL 


LU > 


rH 


rH 


OJ 


OJ 


i in .. 


















CO 


*w* 








H Z -n 


A 


















H* 


H 


h- 


H* 


H- 


FH 














I V 1 


F^ /S 


H X 


O X 


x 


X 


^ H X 


w 














CL 


. OJ 


v UJ 


LU 
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IF DBFUNCT I ON = 4 THEN CALL SNAPTERM; 

/* RESTART, RESTORE ACTIVATED SNAPSHOT */ 
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1.1.0 1 DBTERM: PROCEDURE EXTERNAL; 

111 2 END.; 
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IF DBFUNCTSRVE <> 6FFH THEN RETURN FALSE.; 

/■■*■ NEW FUNCTION INPUT */ 

PERFUNCT I ON = EM.; 
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IF NOT GET INF' THEN RETURN FAL 
/* ILLEGAL ADDRESS INPUT 
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269 2 IF PERFUNCT I ON THEN 

/+ PERIODIC DUMP ACTIVE *■/ 
216 2 DO; 

211 3 IF NOT DBTELLBACK THEN RETURN; 

/+ END OF DUMP */ 
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IF SNFL = G THEN 

/* FIRST CALL, FIND ADDRESS OF SNAPSHOT 
DO; 
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THEN DO; END; 
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172- 2 IF IN ACT HOD = 0FFH THEN RETURN; 

NO MODULE WITH ACTIVE I/O •+/ 

175 2 CSHN22<G> = INACTHOD; 

176 2 IF NOT SEND'/ CSHN22<0>> THEN RETURN; 
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217 3 END; 
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EXTERNAL DECLARATIONS OF SYSTEM DATA 
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EXTERNAL DECLARATIONS OF EXECUTIVE DATA 
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MODSTAT IS AN OVERLAY FOR MODSTfiTUS AND COVER 
THE ENTRIES FOR ONE COMPUTER. 

THE BASE VARIABLE ADRSTAT IS SET AT START. 
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TRUE IF MSG EXTRACTION IS ACTIVATED 
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PRIORLIST CONTAINS THE ADDRESSES OF THE ACTIVATED 
PRIORITY TASKS. 

A PRIORITY TASK IS CALLED WHEN IT IS SCHEDULED BY 
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